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Section 1 


Introduction 


The TMS34010 Graphics System Processor (GSP) is an advanced 32-bit 
microprocessor optimized for graphics systems. The GSP is a member of the 
TMS340 family of computer graphics products from Texas Instruments. The 
TI\/IS34010 is well supported by a full set of hardware and software develop¬ 
ment tools. Including a C compiler, a full-speed emulator, a software simulator, 
an IBM/TI-PC development board, and a math [graphics furictionUbrary. 

The TMS34010 math/graphics function library is a collection of mathematics 
and graphics functions that can be called from C programs. The math functions 
Include standard C double-precision floating-point routines for performing al¬ 
gebraic, trigonometric, and transcendental operations. The graphics functions 
include routines for viewport management, bit-mapped text, graphics output, 
color-palette control, three-dimensional transformations, and graphics Initial¬ 
ization. 

The library can be installed on the following systems: 

• PCs: 

IBM-PC with PC-DOS 
TI-PC with MS-DOS 

• VAX: 

VMS 

DEC Ultrix 
- Unix System V 


Note: 

In order to use the math/graphics function library, you must have the 
TMS34010 assembly language tools package and the TMS34010 C 
compiler. 


The TMS34010 can execute all the functions in the library. Most of the 
functions are system-independent. Some of the graphics functions, however, 
must manage system-dependent features; such functions are compatible with 
the TMS34010 software development board. For more information about 
system-dependent features, see Section 4.17 on page 4-36. 

Topics covered in this introductory section include: 


Section Page 

1.1 Development Tools Overview .1 -2 

1.2 Manual Organization .1-4 

1.3 Related Documentation .1 -5 

1.4 Style and Symbol Conventions.1 -6 


1-1 














Introduction - Development Tools Overview 


1.1 Development Tools Overview 


Figure 1 -1 shows the TMS34010 assembly language development flow. The 
center section of the illustration highlights the most common path; the other 
portions are optional. 
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Introduction - Development Tools Overview 


• The C compiler translates C source code into TI\/IS34010 assembly 
language source code. 

• The assembler translates assembly language source files into machine 
language object files. 

• The archiver allows you to collect a group of files into a single archive 
library. It also allows you to modify the library by deleting, replacing, 
extracting, or adding members. One of the most useful applications of 
the archiver is to build a library of object modules. Several object li¬ 
braries are available as TMS34010 products: 

- The math/graphics function library is discussed in this man¬ 
ual. 

- The font library is a separate product that contains a variety of 
proportionally spaced and monospaced fonts. 

- The runtime-support and floating-point libraries are shipped 
with the C compiler. 

- The CCITT group3/group4 compression/decompression li¬ 
brary. 

The 8514 IBM graphics display library. 

These libraries contain functions that can be called from a C program. 
You can also create your own object libraries. To use an object library, 
you must specify it as linker input; the linker will include the members 
In the library that resolve external references during the link. 

• The linker combines object files into a single executable object module. 
As it creates the executable module, it performs relocation and resolves 
external references. The linker accepts relocatable COFF object files and 
object libraries as Input. 

• The main purpose of this development process Is to produce a module 
that can be executed in a system that contains a TMS34010. You can 
use one of several debugging tools to refine and correct your code; 
available products include: 

A simulator, 

“ A software development board (SDB), and 
An emulator (XDS). 

An object format converter is also available; it converts a COFF ob¬ 
ject file Into a Tektronix-hex, Intel-hex, or Tl-tagged object format file 
that can be downloaded to an EPROM programmer. 
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Introduction ~ Manual Organization 


1.2 Manual Organization 


Section 1 Introduction 

Provides an overview of the function library, describes the TMS34010 devel¬ 
opment support tools, lists related documentation, and explains the style and 
symbol conventions used throughout this document 

Section 2 Installation and Operation 

Contains Instructions for installing the function library on PC and VAX sys¬ 
tems, describes the files that are shipped with the product provides examples 
of compiling, assembling, and linking C code that calls the functions, and 
provides examples of using the archiver with the library. 

Section 3 Math Routines 

Describes the functional categories of math routines, including double- 
precision floating-point functions, single-precision functions, type-conversion 
functions, and math routine error reporting. 

Section 4 Graphics and Text Functions 

Summarizes the graphics and text functions by category and provides general 
information about each category. Contains supplemental information about 
fonts and font management. 

Section 5 Alphabetical Reference of Functions 

Provides a page-by-page alphabetical reference of the functions that are In the 
library. 
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Introduction - Related Documentation 


1.3 Related Documentation 

The following TMS34010 documents are available from Texas Instruments: 

• The TMS34010 C Compiler User's Guide (literature number 
SPVU005) tells you how to use the TMS34010 C compiler. This C 
compiler accepts standard Kernighan and Ritchie C source code and 
produces TMS34010 assembly language source code. We suggest that 
you use The C Programming Language (Kernighan and Ritchie) as a 
companion to the TMS34010 C Compiler User's Guide. 

• The TMS34010 Assembly Language Tools User's Guide (literature 
number SPVU004) describes common object file format assembler di¬ 
rectives, macro language, and assembler, linker, archiver, simulator, and 
object format converter operation. 

• The TMS34010 Font Library User's Guide (literature number 
SPVU007) describes a set of fonts that are available for use in a 
TMS34010-based graphics system. 

• The TMS34010 Data Sheet (literature number SPVS002) contains the 
recommended operating conditions, electrical specifications, and timing 
characteristics of the TMS34010. 

• The TMS34010 User's Guide (literature number SPVU001) discusses 
hardware aspects of the TMS34010, such as pin functions, architecture, 
stack operation, and interfaces, and contains the TMS34010 instruction 
set. 

• The TMS34010 Software Development Board User's Guide (lit¬ 
erature number SPVU002) describes using the TMS34010 software de¬ 
velopment board (a high-performance, PC-based graphics card) for 
testing and developing TMS34010-based graphics systems. 

• The TMS34070 User's Gw/c/e (literature number SPPU016) describes 
the TMS34070 color palette chi^. 

• The TMS34010 Software Development Board Schematics (liter¬ 
ature number SPVU003) is a companion to the TMS34010 Software 
Development Board User's Guide. 

You may also find the following documents useful: 

Cody, William J. Jr. and William Waite. A Software Manual for the Elementary 
Functions. Englewood Cliffs, New Jersey: Prentice-Hall, 1980. 

Kernighan, Brian, and Dennis Ritchie. The C Programming Language. Engle¬ 
wood Cliffs, New Jersey: Prentice-Hall, 1978. 

Newman, W.M., and R.F. Sproull. Principles of Interactive Computer 
Graphics. 2nd ed. New York: McGraw-Hill, 1979. 
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Introduction - Style and Symbol Conventions 


1.4 Style and Symbol Conventions 

• In this document, program listings or examples, interactive displays, file¬ 
names, and symbol names are shown in a special font. Examples use 
a bold version of the special font for emphasis. Here is a sample 
program listing: 

rvalu = 0.0; 
rvalv = 1.0; 

radians = atan(rvalu, rvalv) 

• CR means press the carriage return key. 
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Section 2 

Installation and Operation 


This section contains step-by-step instructions for installing and operating the 
math/graphics function library. The library can be installed on five operating 
systems: 

IBM and Tf PCs 

• PC-DOS1 (IBM PC) 

• MS-DOS2 (Tl PC) 

Digital Equipment Corporation VAX-11^ 

• VMS operating system 

• DEC Ultrix operating system 

• Unix System V operating system 

To use the math/graphics function library, you need the following software 
tools and object libraries: 

• TMS34010 C compiler 

• TMS34010 assembly language tools package (assembler, linker, 
and archiver) 

• Runtime-support and floating-point libraries (rts. lib and 
flib.lib)4 

The TMS34010 C Compiler User's Guide and TMS34010 Assembly Language 
Tools User's Guide describes these tools. 

You will find Instructions for installing and using the library In the following 
sections: 


Section Page 

2.1 PC Installations . 2-2 

2.2 VAX/VMS Installation .2-3 

2.3 VAX/ULTRIX and System V Installation .2-3 

2.4 Using the Library .2-4 


PC-DOS is a trademark of International Business Machines. 

2 MS is a trademark of Microsoft Corporation. 

3 VAX-11 and VMS are trademarks of Digital Equipment Corporation. 

4 These libraries are shipped with the TMS34010 C compiler. 
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Software Installation for PCs 


2.1 Installation for IBM/TI PCs with PC/MS-DOS 

The math/graphics function library is shipped on several double-sided, dual¬ 
density diskettes. 

The installation instructions use these symbols for drive names: 

A: Floppy disk drive. 

C: Winchester or hard disk (E: on Tl PCs). 

1) Make backups of the product diskettes. 

a) First format several blank diskettes. Insert a blank (destination) 
diskette in drive A. Enter: 

FORMAT A: CR 

b) Now copy the disks; enter: 

DISKCOPY A: A: CR 

Follow the system prompts, removing and inserting the product 
and blank diskettes as directed. 

2) Create a directory to contain the TMS34010 software. Enter: 

MD C:\GSPLIB CR 

3) Copy the files onto the hard disk. Insert a product diskette in drive A. 
Enter: 

COPY A:\*.* C:\GSPLIB\*.* CR 




Software Installation for VAX Systems 


2.2 Installation for VAX/VMS 

The tape was created with the VMS BACKUP utility at 1600 BPI. 

1) Mount the tape on your tape drive. 

2) Execute the following commands. Note that you must create a destina¬ 
tion directory for the tools; In this example, DEST : directory represents 
that directory. Replace TAPE; with the name of the tape drive you are 
using. 

$ allocate TAPE: 

$ mount/for/den=1600 TAPE; 

$ backup TAPE:GSP.bck DEST;directory 

$ dismount TAPE: 

$ dealloc TAPE: 


2.3 Installation for VAX/ULTRIX and VAX/System V 

This tape was made at 1600 BPI using the TAR utility. Follow these in¬ 
structions to install the software: 

1) Mount the tape on your tape drive. 

2) Make sure that the directory in which you will store the tools is the cur¬ 
rent directory. 

3) Enter the TAR command for your system; for example, 

TAR X 

This copies the entire tape into the directory. 
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Installation and Operation - Using the Library 


2.4 Using the Library 

Several types of files are shipped with the math/graphics library product: 

• Object libraries {.Ub extension). These libraries contain the compiled, 
assembled versions of the functions; libraries are in archive format The 
object libraries that are shipped with this product include: 

grafix.lib 
vuport.lib 
text.lib 
math.lib 

• Source libraries {.src extension). These libraries contain the C source 
or assembly language source versions of the functions; libraries are in 
archive format. The source libraries that are shipped with this product 
include: 

grafixl.src 
grafix2.src 
grafix3.src 
vuport.src 
text.src 
math.src 

• Batch and command files {.bat and .cmd extensions): 

- gspc.bat invokes the compiler (preprocessor, parser, and code 
generator) and the assembler. 

- Ic.bat invokes the linker and calls a linker command file named 
Ic. cmd. 


Notes: 

1. Ic.bat expects Ic.cmd to be In a directory named gsplib. 

2. Ic.cmd expects the functions In the math/graphics library to be in a 
directory named gsplib; it expects the rts.lib and f lib. lib li¬ 
braries to be in a directory named gsptools. 


Refer to the product release notes for a complete list of the files that are 
shipped with the product. 
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installation and Operation - Using the Library 


2.4.1 Creating an Object Module that Contains Called Functions 

Most of the the math/graphics functions can be called from a C program. 
(The syntaxes of various function calls are defined in later sections). To use 
the functions, you must compile, assemble, and link the C source program that 
calls the functions. When you link the resulting object file, you must also link 
in the appropriate function library. Whenever you specify an object library as 
linker input, the linker automatically includes the library members that contain 
called functions or resolve symbol references. 

Example 2-1 and Example 2-2 show methods for compiling, assembling, and 
linking a C source program that calls functions in the function library. Note 
that the examples are for PC/MS-DOS systems. In these examples, assume 
that a file named test.c calls the functions open—vuport, select—vuport, and 
close—vuport; these functions are in the library \gsplib\vuport. libs. 

Example 2-1. Method 1 - Invoke Each Tool Individually 


1) Compile test. c: 

a) gspcpp test 

C Pre-Processor, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 

b) gspcc test 

GSP C Com;piler, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 
"test.c” ==> main 

c) gspcg test 

GSP C Codegen, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 
"test.c" ==> main 

This creates an output file named test. asm. 


2) Assemble test. asm: 
gspa test 

GSP COFF Assembler, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 

PASS 1 
PASS 2 

No Errors, No Warnings 

This creates an output file named test.obj. 

3) Set the environment variable so the linker can find the object li¬ 
braries: 

set C—DIR = \libs; \gsplib 

4) Link test. obj with the appropriate object libraries: 

gsplnk test vuport.libs rts.lib flib.lib -o test.out 

GSP COFF Linker, Version x.x, 87.260 

(C) Copyright 1985, 1987, Texas Instruments Inc. 

This creates an object module called test.out. 





Installation and Operation - Using the Library 


Example 2-2. Method 2 - Use the Batch Files to Invoke the Tools 


1) Use the gspc.bat file to compile and assemble test.c: 

gspc test 
-[test]- 

C Pre-Processor, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 

GSP C Compiler, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 
"test.c" ==> main 

GSP C Codegen, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 
"test.c" ==> main 

GSP COFF Assembler, Version x.x, 87.100 

(c) Copyright 1985, 1987 Texas Instruments Inc. 

PASS 1 
PASS 2 

No Errors, No Warnings 

Successful Compile of Module test 

2) Use the Ic.bat file to link test .obj. Ic.bat calls a linker com¬ 
mand file named Ic.cmd that automatically links in the object li¬ 
braries. 

Ic test 

gsplnk -c -m test.map -o test.out test.obj 
\gsplib\lc.cmd 

GSP COFF Linker, Version x.x, 87.260 

(C) Copyright 1985, 1987, Texas Instruments Inc. 

This creates an object module called test.out. 


2.4.2 Archive Files 

An archive file (or library) is a partitioned file that contains complete files as 
members. The math/graphics function library contains two types of libraries: 

• Source libraries, which contain the source versions of the functions as 
members. 

• Object libraries, which contain the compiled, assembled versions of the 
functions as members. 

The TMS34010 archiver is a software utility that allows you to manipulate the 
members of a library by adding members, extracting members, deleting mem¬ 
bers, and replacing members. The TMS34010 Assembly Language Tools Us¬ 
er's Guide contains complete instructions for using the archiver. Example 2-3, 
Example 2-4, and Example 2-5 show how you might use the archiver to ma¬ 
nipulate the math/graphics libraries. 
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Example 2-3. Listing the Contents of a Library 


Since the math/graphics library contains several abject archive files, you 
may want to list the contents of the individual libraries so that you can 
determine which functions reside in which libraries. To do this, invoke the 
archiver with the -t option: 

gspar -t \gsplib\vuport.lib 

GSP Archiver Version x.x, 87.261 

(c) Copyright 1985, 1987, Texas Instruments Inc. 


FILE NAME 

SIZE 

DATE 




set—visr.asm 

4961 

Mon 

Mar 

9 

11:03:32 

1987 

close—vu.c 

2532 

Tue 

Mar 

31 

08:14:56 

1987 

copy—vup.c 

6891 

Tue 

Mar 

31 

08:29:40 

1987 

initvupo.c 

2716 

Tue 

Mar 

3 

15:05:06 

1987 


Example 2-4. Extracting and Replacing a Member 


Assume that you want to modify a function called close—vuport The 
source code for this function is in the library \gsplib\vuport. src; the 
object code for this function is in the library \gsplib\vuport. lib. 
Follow these steps to create a new object file and replace it in the library: 

1) Extract the function from the source library (the -x option tells the 
archiver to extract the specified member): 

gspar -xv \gsplib\vuport.lib close—vu.c 

GSP Archiver Version x.x, 87.261 

(c) Copyright 1985, 1987, Texas Instruments Inc. 

==> extract 'close—vu.c' 

2) Edit the source file. 

3) Compile and assemble the modified function: 

gspc close—vuport 

4) Replace the version of close—vu.obj that is in the library with the 
new version (the -r option tells the archiver to replace the specified 
member): 

gspar -rv \gsplib\vuport.lib close—vu.obj 

GSP Archiver Version x.x, 87.261 

(c) Copyright 1985, 1987, Texas Instruments Inc. 

==> replace 'close—vu.c' 

==> building archive '\gsplib\vuport.lib' 

Note that the v command tells the archiver to print supplementary status 
Information. 


2-7 









Instaliation and Operation - Using the Library 


Example 2-5. Extracting all the Members from a Library 
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Section 3 


Math Routines 


The math routines are a collection of algebraic, trigonometric, and transcen¬ 
dental functions on real arguments. The library includes: 

• Double-precision, floating-point functions that can be called from C. 

These functions conform to the ANSI C standard function names and 
definitions. The arguments that are Input to these functions and the 
values that are returned from them are double-precision, floating-point 
numbers. The TMS34010 C Compiler User's Guide describes floating¬ 
point formats. 

Double-precision, floating-point math errors are reported by means of 
the customizable fp—error function (discussed in the TMS34010 C 
Compiler User's Guide). An error number Is assigned to each type of 
error; refer to Section 3.2 for a list of errors and their associated error 
numbers. 

• Single-precision functions that can be called from assembly language. 

These functions mctude addition, multiplication, sine, cosine, and con¬ 
version between single-precilslon floating-point format and 32-bit 
fixed-point format. The math routines are Implemented in TI\/IS34010 
assembly language, and call functions contained in the floating-point 
library flib.lib. The TMS34010 C Compiler User's Guide describes 
floating-point formats. The functions use a 32-bit fixed-point format, 
which is a 2s complement representation with 16 bits of integer and 16 
bits of fraction. 

• Type-conversion functions that can be called from C. 

These functions convert SJrrays of numbers between floating-point, 
fixed-point, short-Integer, and long-integer representations. The func¬ 
tions accept an input array of one type and produce an output array of 
another type. 

The algorithms used in the trigonometric, logarithmic, hyperbolic, and expo¬ 
nential functions are adapted from A Software Manual for the Elementary 
Functions (Cody and Waite). 

Topics in this section include: 


Section Page 

3.1 Double-Precision Functions. 3-2 

3.2 Math Routine Error Reporting.3-4 

3.3 Single-Precision Routines .3-5 

3.4 Array Conversion Functions .3-5 
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Math Routines - Double-Precision Functions 


3.1 Double-Precision Functions 

These math routines can be called from a C program. 


Function Name 

Description 

double acos(x) 
double x; 

Returns a double-precision number that represents the 
arc cosine of x. 

double asin(x) 
double x; 

Returns a double-precision number that represents the 
arc sine of x. 

double atan(x) 
double x; 

Returns a double-precision number that represents the 
arc tan of x. 

double atan2(u,v) 
double u,v; 

Returns a double-precision number that represents the 
arc tangent of u divided by v. 

double ceil(x) 
double x; 

Returns a double-precision number that represents the 
smallest integer greater than or equal to x. 

double cos(x) 
double x; 

Returns a double-precision number that represents the 
cosine of x. 

double cosh(x) 
double x; 

Returns a double-precision number that represents the 
hyperbolic cosine of x. 

double cotan(x) 
double x; 

Returns a double-precision number that represents the 
cotangent of x. 

double exp(x) 
double x; 

Returns a double-precision number that represents the natural 
number e raised to the power of x (e^). 

double fabs(x) 
double x; 

Returns a double-precision number that represents the 
the absolute value of x. 

double floor(x) 
double x; 

Returns a double-precision number that represents 
the largest Integer less than or equal to the value of x. 

double fmod(x,y) 
double x,y; 

Returns a double-precision number that represents the 
remainder of x divided by y, according to the formula x-yxN, 
where N is the quotient of x/y truncated to an integer. 

double frexp(value, exp) 
double value; 

Breaks a double-precision number into a normalized 
fraction and an exponent. 

double ldexp(value, exp) 
double value; 
int exp; 

Returns value x2®^P; commonly used 
to rebuild a double-precision number. 

double log(x) 
double x; 

Returns a double-precision number that represents the 
natural logarithm (base e) of x; that is, ln(x). 

double loglO(x) 
double x; 

Returns a double-precision number that represents the 
common logarithm of x; that is, log io(x). 

double modf(value, exp) 
double value; 
int *exp; 

Breaks a double-precision number into a signed 
fraction and a signed integer. 

double pow(x,y) 
double x,y; 

Returns a double-precision number that represents 

X raised to the power of y; that is, xV. 

double sin(x) 
double x; 

Returns a double-precision number that represents the 
sine of x. 

double sinh(x) 
double x; 

Returns a double-precision number that represents the 
hyperboljic sine of x. 

double sqrt(x) 
double x; 

Returns a double-precision number that represents the 
square root of x. 

double tan(x) 
double x; 

Returns a double-precision number that represents the 
tangent of x. 

double tanh(x) 
double x; 

Returns a double-precision number that represents the 
hyperbolic tangent of x. 
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3.2 Math Routine Error Reporting 


Error Code 

(decimal) 

Error Code 

(hexadecimal) 

Error Description 

Functions 
Generating 
the Error 

17 

11 

Argument >1.0 E+8 
default result is zero 

sin 

cos 

18 

12 

abs(argument) >1.0 
default result \s ±co 

asin 

acos 

19 

13 

abs(argument) <1.0 E-300 

default result is ±oo 

cotan 

20 

14 

abs(argument) >1.0 E+8 

default result is zero 

cotan 

tan 

21 

15 

argument > 500 

default result is ±ao 

exp 

22 

16 

argument < -500 
default result is zero 

exp 

23 

17 

Both arguments = 0.0 

default result is +oo 

atan2 

24 

18 

where X < 0 

default result is (-X)^ 

pow 

25 

19 

X^, where X=0 and YsO 

default result is -oo 

pow 

26 

1A 

Argument ^ 0 

default result is - oo 

log 

logic 

27 

1B 

X^ results in overflow 

default result is +oo 

pow 

28 

1C 

X^ results in underflow 

default result is zero 

pow 
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Math Routines ~ Single-Precision Routines/Array Conversion Functions 


3.3 Single-Precision Routines 

These math routines can be called from assembly language programs by using 
the EXGPC instruction. 


Function 

Name 

Description 

FL-ADD 

Adds two single-precision floating-point values. 

FL_COS 

Calculates the cosine of a real number that represents an angle ex¬ 
pressed in radians. 

FU-MULT 

Multiplies two single-precision floating-point values. 

FL-SIN 

Calculates the sine of a real number that represents an angle expressed 
in radians. 

FIX2FL 

Converts a fixed-point number to a single-precision floating-point 
number. 

FL2FIX 

Converts a single-precision floating-point number to a fixed-point 
number. 


3.4 Array Conversion Functions 

These conversion routines can be called from C programs. 


Function 

Name 

Description 

fix—to—float 

Convert an array of fixed-point numbers to an array of single-precision 
floating-point numbers. 

fix—to—long 

Convert an array of fixed-point numbers to an array of long integers. 

fix—to—short 

Convert an array of fixed-point numbers to an array of short integers. 

float—to—fix 

Convert an array of single-precision floating-point numbers to an array 
of fixed-point numbers. 

long—to—fix 

Convert an array of long Integers to an array of fixed-point numbers. 

short—to—fix 

Convert an array of short integers to an array of fixed-point numbers. 
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Section 4 


Graphics and Text Functions 


The Math/Graphics Function Library contains a variety of graphics and text 
functions. The graphics functions: 

• Perform viewport management. 

• Produce graphics output including: 

~ Lines, 

“ Ellipses, 

- Arcs, and 
“ Polygons. 

• Provide color palette control. 

The text functions: 

• Provide the capability for drawing bit-mapped text to the screen. 

• Allow you to select among a variety of fonts. 

• Supply information about text attributes. 

The library supports both proportionally spaced and monospaced fonts, and 
includes several fonts. Additional fonts are available with the TIV1S34010 Font 
Library (see the TMS34010 Font Library User's Guide for more information). 

This section describes the graphics and text functions: 

Section Page 

4.1 Summary Table (Functional Grouping) .4-2 

4.2 Graphics System Initialization Functions .4-6 

4.3 3D Transformation Functions .4-7 

4.4 Text Output Functions . 4-8 

4.5 Text Attribute Inquiry and Control Functions.4-9 

4.6 Font Management Functions.4-11 

4.7 Available Fonts . 4-14 

4.8 Graphics Output Functions ..4-16 

4.9 Graphics Attribute Control Functions.4-19 

4.10 Fill Patterns . 4-20 

4.11 Color Palette Functions.4-23 

4.12 Pixel and Pixel Array Manipulation Functions . 4-24 

4.13 Viewport Management Functions .4-25 

4.14 Miscellaneous Functions.4-28 

4.15 Special Data Formats.4-29 

4.16 Mapping Pixels to XY Coordinates ..4-33 

4.17 System Implementation issues .4-36 
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Graphics and Text Functions - Summary Table 


4.1 Summary Table (Functional Grouping) 


Graphics System Initialization Functions 

Function 

Description 

clear—screen 
init—grafix 
in it—pa let 
init—screen 
init—text 
init—video 
init—vu port 
new—screen 

Clears the entire screen to a specified pixel value. 

Initializes the graphics environment 

Sets the color lookup table to default palette values. 

Clears the screen and sets the palette to default colors. 

Initializes text data structures and installs the system font. 
Initializes video timing and screen refresh registers. 

Initializes viewport data structures and opens viewport 0. 

Clears the entire screen and initializes the color palette. 

3D Transformation Matrix Functions | 

Function 

Description 

copy—matrix 

copy—vertex 

init—matrix 

perspec 

rotate 

scale 

transform 

translate 

vertex—to—point 

Copies an input matrix to an output matrix. 

Copies an input vertex list to an output vertex list. 

Initializes an array to a 4-by-4 identity matrix. 

Performs perspective transformation on a list of vertices. 

Rotates a 3D matrix in the XY, YZ, and ZX planes. 

Scales a matrix in the X, Y, and Z dimensions. 

Uses a matrix to transform a vertex list. 

Translates a matrix by displacements in X, Y, and Z. 

Converts a list of 3D vertices to a list of 2D points. 

Text Output Functions | 

Function 

Description 

draw—char 
draw-string 

Draws a single bit-mapped character to the screen. 

Draws a string of bit-mapped characters to the screen. 

Text Attribute Inquiry and Control Functions | 

Function 

Description 

add—text—space 
char—high 
char—wide—max 
get—ascent 
get—descent 
get—first—ch 
get—last—ch 
get—leading 
get—width 

Incrementally adjusts horizontal spacing between characters. 
Returns the character height for the selected font. 

Returns the maximum character width in the selected font. 

Returns the ascent value for the selected font. 

Returns the descent value for the selected font. 

Returns the first character represented in the selected font. 

Returns the last character represented in the selected font. 

Returns the leading value for the selected font. 

Returns the pixel width of the specified character string. 

Font Management Functions 

Function 

Description 

get—font—max 
install—font 
select—font 

Returns the maximum number of installed fonts, 
installs a font and assigns the designated index. 

Selects a previously installed font. 

1 Graphics Output Functions | 

Function 

Description 

bound—fill 
bound—patnfill 
draw—line 
draw—oval 
draw—ovalarc 
draw—piearc 
draw—point 

Fills to a specified boundary color. 

Fills to a specified boundary color with pattern. 

Draws a pixel-thick line between two points. 

Draws the outline of an ellipse one pixel thick. 

Draws an elliptical arc one pixel in thickness. 

Draws a one-pixel-thick outline of a pie slice of an ellipse. 

Draws a pixel at designated coordinates. 
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1 Graphics Output Functions (continued) | 

Function 

Description 

draw—polyline 

Draws a list of one-pixel-thick lines. 

draw—rect 

Draws an outline of a rectangle one pixel thick. 

fill—convex 

Draws a solid-filled convex polygon. 

fill—oval 

Draws a solid-filled ellipse. 

fill—piearc 

Draws a solid-filled pie slice of an ellipse. 

fill—polygon 

Draws a solid-filled polygon. 

fill—rect 

Draws a solid-filled rectangle. 

frame—oval 

Draws a solid elliptical border of specified thickness. 

frame—rect 

Draws a solid rectangular border of specified thickness. 

patnfill—oval 

Draws a pattern-filled ellipse. 

patnfill—polygon 

Draws a pattern-filled polygon. 

patnfill—rect 

Draws a pattern-filled rectangle. 

patnframe—oval 

Draws a pattern-filled elliptical border of specified thickness. 

patnframe—rect 

Draws a pattern-filled rectangular border of specified thickness. 

patnfill—convex 

Draws a pattern-filled convex polygon. 

patnfill—piearc 

Draws a pattern-filled pie slice of an ellipse. 

patnpen—line 

Uses a pen and pattern to draw a line between two points. 

patnpen—ovalarc 

Uses a pen and pattern to draw an elliptical arc. 

patnpen—piearc 

Uses a pen and pattern to draw a pie slice of ellipse. 

patnpen—point 

Draws a pattern-filled pen at designated coordinates. 

patnpen—polyline 

Uses a pen and pattern to draw a list of lines. 

pen—line 

Uses a solid pen to draw a line between two points. 

pen—ovalarc 

Uses a solid pen to draw an elliptical arc. 

pen—piearc 

Uses a solid pen to draw a pie slice of an ellipse. 

pen—point 

Draws a solid-filled pen at designated coordinates. 

pen—polyline 

Uses a pen to draw a list of lines. 

seed—fill 

Seed (or flood) fills a connected region with a solid color. 

seed—patnfill 

Seed fills a connected region with a pattern. 

styled—line 

Draws a styled line between two points. 

1 Pixel and Pixel Array Manipulation Functions | 

Function 

Description 

bit—expand 

Expands a two-dimensional bit array to colors 0 and 1. 

get—pixel 

Reads a pixel from the specified coordinates. 

get—rect 

Copies a rectangular area of the screen into a pixel array. 

move—pixel 

Moves a pixel from source to destination. 

move—rect 

Moves pixels from source rectangle to destination. 

put—pixel 

Writes a pixel to the specified coordinates. 

put—rect 

Copies a pixel array to a rectangular area of screen. 

run—decode 

Decompresses a run-length encoded image onto the screen. 

run—encode 

Stores the on-screen image in run-length encoded form. 

zoom—rect 

Zooms a source rectangle to fit a destination rectangle. 

1 Graphics Attribute Control Functions \ 

Function 

Description 

get—patn—max 

Returns the maximum number of installed patterns. 

get—pmask 

Returns the current color plane mask. 

get—ppop 

Returns the current pixel processing option. 

get—psize 

Returns the current pixel size. 

get—transp 

Returns the current transparency flag. 

install—patn 

Installs a 16-by-16 bit map in the pattern table. 

select—patn 

Selects a pattern from the pattern table. 

set—colorO 

Sets the background color. 

set—CO lor 1 

Sets the foreground color. 

set—pensize 

Sets the pen width and height. 

set—pmask 

Sets the color plane mask. 

set—ppop 

Sets the pixel processing operation. 

transp—off 

Disables the pixel attribute of transparency. 

transp—on 

Enables the pixel attribute of transparency. 
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Color Palette Functions 

Function 

Description 

color—blend 

geta II—pa let 
set—pa let 
setall—paiet 

Blends from starting color to ending color over a specified block 
of scan lines. 

Reads multiple registers in the color lookup table. 

Loads specified register in the color lookup table. 

Loads multiple registers in the color lookup table. 

Viewport Management Functions 

Function 

Description 

close—vu port 
copy—vu port 
cpw 

get—vu port—max 
move—vu port 
open—vu port 
select—vuport 
set—cliprect 
set—origin 
size—vuport 

Closes a viewport. 

Copies attributes of one viewport to another. 

Compares a point to a window (visibility rectangle). 

Returns the maximum number of open viewports. 

Moves a viewport to a new position on screen. 

Opens a new viewport and returns its index. 

Selects a viewport that Is already open. 

Sets the size and position of a clipping rectangle. 

Sets the position of a viewport-relative origin. 

Changes the size of a viewport. 

Miscellaneous Graphics Functions 

Function 

Description 

delay 

lib-id 

Imo 

peek 

peek—breg 
poke 

poke—breg 
rep—pixel 
rmo 

wait—scan 
xytoaddr 

Waits for the specified number of ticks (tick = 1/60 second). 
Returns a string identifier for the library revision. 

Returns the bit number of the leftmost one in an argument. 
Returns the specified word in memory. 

Returns the specified B-file register. 

Writes a value to the specified word In memory. 

Writes a value to the specified B-file register. 

Replicates a pixel value throughout a 32-bit integer. 

Returns the bit number of the rightmost one in an argument. 
Waits for the designated horizontal line to be scanned. 

Converts XY coordinates to the memory address of pixel. 
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4.2 Graphics System Initialization Functions 

These functions initialize the software graphics environment by: 

• Setting selected I/O registers and B-file registers to appropriate 
initial values, 

• Assigning default values to key variables, 

• Clearing the screen, and 

• Setting the color palette to default values. 

Table 4-1 summarizes the graphics system initialization functions. 


Table 4-1. Summary of Graphics System Initialization Functions 


Function Name 

Description 

clear—screen 

Clears the frame buffer to the specified pixel value. 

init—grafix 

Initializes the graphics environment. This function must be called 
before using any of the graphics output functions. 

init—palet 

Loads the default color palette into the color lookup table. 

init—screen 

Clears the frame buffer to the specified pixel value and loads the 
default color palette values into the color lookup table. 

init—text 

Initializes the text data structures, and opens the system font as 
font number 0. This function must be called before using any of 
the text functions. 

init-video 

Initializes CRT control timing, enables screen refresh, and defines 
screen dimensions and pixel size. This function must be called 
before using the initialization functions init—grafix and 
init—vu port. 

init—vu port 

initializes viewport data structures, and opens system viewport 0 
as the system viewport. This function must be called before using 
any of the viewport functions. 

new—screen 

Clears the frame buffer to the specified pixel value, and loads the 
specified color palette values into the color lookup table. 
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4.3 3D Transformation Functions 

These functions allow you to rotate, scale, translate, and apply perspective 
transformations to points in three-dimensional space. You can use these 
functions to construct a a 4x4 homogeneous transform matrix, and transform 
the object that the matrix represents through a series of rotations, scalings, and 
translations. You can then use the resulting matrix to transform an object re¬ 
presented as a list of 3D points. 

The Z coordinate axis used for 3D operations is assumed to be perpendicular 
to the face of the screen. The positive Z direction moves away from a person 
who is looking at the screen (into the screen). The face of the screen Is at 
Z=0. The X axis is horizontal along the face of the screen; the positive X di¬ 
rection is left to right. The Y axis is vertical along the face of the screen; the 
positive Y direction is top to bottom. You can use the viewport functions in¬ 
cluded in the library to move the XY origin used for graphics output. The de¬ 
fault location of the origin is at the top left corner of the screen; this is the 
location of the origin following initialization. 

Points In three-dimensional space are represented in a data structure called a 
vertex list. Each point in the vertex list is represented by three coordinates, 
(X,Y,Z). The vertex list can be converted to a list of two-dimensional points, 
each specified by two coordinates, (X,Y), to facilitate their use by graphics 
output functions such as draw—polyline and fill—polygon. 

Vertex list elements and transformation elements are represented as 32-bit 
fixed-point values. The fixed-point format Is not a standard C data type, but 
is an internal data format used by several library functions. A fixed-point value 
Is a 32-bit, 2s complement value whose 16 LSBs lie to the right of the binary 
point. 

Table 4-2 summarizes the matrix functions. Refer to Principles of Interactive 
Computer Graphics (Newman and Sproull) for a description of homogeneous 
coordinate transformations. 

Table 4-2. Summary of 3D Transformation Functions 


Function Name 

Description 

copy—matrix 

Copies a 4x4 matrix. 

copy—vertex 

Copies a vertex list (list of three-dimensional vertices). 

in it—matrix 

Initializes a 16-element array to a 4x4 Identity matrix. 

perspec 

Performs perspective transformation on a vertex list (list of three- 
dimensional vertices). 

rotate 

Rotates a matrix by specified angles in the XY, YZ, and ZX planes. 

scale 

Scales a matrix by specified scaling factors In the X, Y, and Z di¬ 
mensions. 

transform 

Uses a 4x4 transformation matrix to transform a list of three-di¬ 
mensional vertices. 

translate 

Translates a matrix by specified displacements in the X, Y, and Z 
directions. 

vertex—to—point 

Converts a vertex list (list of three-dimensional vertices) to a list 
of two-dimensional points. 
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4.4 Text Output Functions 

The text output functions draw bitmapped text to the screen. The library 
supports both proportionally spaced and monospaced fonts. Text can be 
placed at arbitrary positions on the screen. Table 4-3 summarizes the text 
output functions. 

Table 4-3. Summary of Text Output Functions 


Function Name 

Description 

draw—char 

Draws a single character to the screen using the current font. 

draw-string 

Draws a string of characters to the screen using the current font. 
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4,5 Text Attribute Inquiry and Control Functions 

These functions provide you with values that are associated with text attri¬ 
butes. Several attributes, including ascent, descent, leading, character height. 

Figure 
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Figure 4-1. Text Attributes 


• The character origin is a point on the baseline that is positioned at the 
left side of the character pattern. This point is used as a reference for 
locating the character to be drawn. 

• The character rectangle is a rectangle that encloses the character 
image. The sides of the rectangle are defined by the image width and 
the character height. For example, in Figure 4-1, the character rectangle 
for Q Is seven pixels wide and ten pixels high. 

• The character width is the image width plus the space separating this 
character from the next character. The character width can vary within 
a font and between fonts. 

• The image width Is the width in pixels of the portion of the character 
pattern bitmap that contains the character image, excluding the space to 
the right of the character. The image width can vary within a font and 
between fonts. 

• The ascent line is a horizontal line that coincides with the top of the 
highest-reaching character in the font. The ascent value Is the difference 
between the Y coordinates of the ascent line and the baseline. 

• The baseline is an imaginary horizontal line that coincides with the 
bottom of each character, excluding descenders. The starting Y coordi- 


and character width, are associated with each font in the font library. 
4-1 Illustrates these attributes. 


character 

rectangle 



character 

rectangle 
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nate given to the draw-string or draw—char function specifies the Y 
value of the baseline. The starting X coordinate specifies the left edge 
of the first character. The starting X and Y coordinates together define 
the character origin of the first character In the string. 

• The descent line is a horizontal line that coincides with the bottom of 
the character having the lowest-reaching descender in the font. The 
descent value is the difference between the Y coordinates of the descent 
line and the baseline. 

• The character height is the vertical separation between successive 
rows of text, and is the sum of the ascent, descent, and leading values. 

• The leading is the vertical spacing between the bottom of one row of 
characters and the top of the row of characters below it. The leading 
value is calculated as difference in Y coordinates of the descent line of 
one row of characters and the ascent line of the row of characters below 
that row. 

Table 4-4 summarizes the text attribute functions. Refer to the TMS34010 

Font Library User's Guide for additional information on the font data structure. 

Table 4-4. Summary of Text Attribute Inquiry Functions 


Function Name 

Description 

add—text—space 

Specifies a value to be added to the default horizontal spacing 
between characters. 

char—high 

Returns the character height for the current font. 

get—first—ch 

Returns the first character represented in the current font. 

get—last—ch 

Returns the last character represented In the current font. 

char—wide—max 

Returns the maximum character width in the current font. 

get—ascent 

Returns the ascent value for the current font. 

get—descent 

Returns the descent value for the current font. 

get—leading 

Returns the leading value for the current font. 

get—width 

Returns the width (in pixels) of a specified character string drawn 
in the current font. 
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4.6 Font Management Functions 

The font management functions allow you to install a text font and select one 
of the installed fonts for use. The function library includes several bit-mapped 
text fonts; additional fonts are available with the TI\/IS34010 Font Library. 
Table 4-5 summarizes the font management functions. 

Table 4-5. Summary of Font Management Functions 



Function Name 

Description 

get—font—max 

Returns the maximum number of fonts that can be 
installed. 

install—font 

Installs a new font, and assigns an index to it 

select—font 

Selects a previously installed font. 



Each font is fully described by a font data structure, which contains the char¬ 
acter pattern bitmap and other information necessary to extract individual 
character patterns from the bitmap. Figure 4-2 shows the C definition for this 
structure. 


/* - 

* TMS34010 Graphics Function Library 

* ____ 

* font—struct data structure 

* 

* Data structure for storage of text font bit map and attributes. 

* The charpatn[], loctablef], and owtable[] arrays vary in size 

* according to the font. This is the reason they are given dummy 

* declarations below. The routines that manipulate these arrays 

* are written in assembly code. 


struct font—struct { 
short fonttype; 
short firStchar; 
short lastchar; 
short widemax; 
short kernmax; 
short ndescent; 
short frectwide; 
short charhigh; 
short owtloc; 
short ascent; 
short descent; 
short leading; 
short rowwords; 

/* short charpatn[n] 
/* short loctablein] 
/* short owtable[n]; 


/* font type code */ 

/* ASCII code of first character */ 

/* ASCII code of last character */ 

/* maximum character width */ 

/* maximum character kerning amount */ 

/* negative of the descent value */ 

/* width of font rectangle */ 

/* character height */ 

/* offset to offset/width table */ 

/* ascent (how far above baseline) */ 

/* descent (how far below baseline) */ 

/* leading (row bottom to next row top) */ 
/* no. of words per row of char patterns */ 
; character pattern bitmap */ 

; character offsets in charpatn */ 

offset/width table */ 


typedef struct font—struct FONT; 
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fonttype 

firstchar 

lastchar 

widemax 

kernmax 

ndescent 

frectwide 

charhigh 

owtloc 

ascent 

descent 

leading 


and thus can be explicitly manipulated in a C program. The last three members 
(arrays charpatn, loctable, and owtable) have variable lengths; they are 
given dummy declarations in the structure definition above, and are manipu¬ 
lated by assembly language routines. The font structure members are defined 
as follows: 

Font type code. This code designates the type of font. Proportionally spaced 
fonts are Identified by a fonttype value of 9000h. (The software treats even 
monospaced fonts such as Corpus—Christ! as proportionally spaced fonts.) 

ASCII code of first character. The f irstchar value identifies the lowest AS¬ 
CII code for which a character pattern (other than the missing character pat¬ 
tern) is provided. 

ASCII code of last character. The lastchar value identifies the highest ASCII 
code for which a character pattern (other than the missing character pattern) 
Is provided. 

Maximum character width. The widemax value is the character width of the 
widest character in the font. It equals the sum of the image width and the 
space to the right of the character image. 

Maximum character kerning amount. The font structure permits character 
kerning; that Is, a character's pattern may overlap the space occupied by the 
character to Its left. The kerning amount is the number of horizontal pixels of 
overlap, and Is equal to the portion of the Image width of the character that 
falls to the left of the character origin. It should always be 0 or negative. The 
kernmax is the maximum kerning amount for ail characters in the font. 

Negative of the descent value. The ndescent value Is the negative (2s com¬ 
plement) of the number of pixels between the baseline and the descent line 
for the font. 

Width of font rectangle. The f rectwide is the width of the widest character 
image In the font. Whereas widemax represents the sum of the image width 
and the space to the right of the character, frectwide represents only the 
image width. 

Character height. The charhigh value represents the vertical distance (in 
pixels) between the baseline of one row of text and the baseline of the fol¬ 
lowing row. It equals the sum of the ascent and the descent. The charhigh 
value Is also the number of rows in the bitmap representing the character 
patterns for the font. 

Offset to offset/width table. The owtloc value is the word offset from itself to 
the start of the owtable array. It Is equivalent to 4+ (rowwords x charhigh) 
+ (lastchar-f irstchar+3)+1. 

Ascent. The ascent value is the vertical distance (in pixels) from the baseline 
to the ascent line for the font. 

Descent. The descent value is the vertical distance (in pixels) from the de¬ 
scent line one row of text to the ascent line of the next row of text beneath it. 

Leading. The leading is the vertical distance (in pixels) from the descent line 
of one row of text to the ascent line of the next row of text beneath it. 
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rowwords Number Of words per row of character pattern bitmap. The rowwords value 
Is the width (in words) of the bitmap containing the patterns for the characters 
in the font The pitch (width In bits) of the bitmap is obtained by multiplying 
rowwords by 16. 

charpatn[n] C/7aracfe/' pattern bitmap. Figure 4-1 shows the format of the character pat¬ 
tern bitmap contained in the charpatn array. The last character image in the 
bitmap is that of the missing symbol. The top row of the bitmap contains the 
top row of the image for each character In the font; the second row contains 
the second row of the Image for each character; and so on. The storage space 
In words required by the bitmap is calculated as (rowwords x charhigh). 

loctable [n] Tabie for locating individual character images in the character pattern bitmap. 

The loctable member corresponding to a particular ASCII character code 
gives the offset in bits from the start of the charpatn array to the start of the 
Image for that character. The loctable array contains entries only for ASCII 
characters first char through lastchar, plus the missing character. The to¬ 
tal number of members in the loctable array Is equal to a? = (lastchar- 
firstchar+3). The location of the first character is contained in 
loctable [0]; the location of the last character is contained in 
loctable[lastchar-firstchar]. The location of the missing character is 
contained in loctable[lastchar-f irstchar + 1 ]. The final array member, 
loctable[lastchar~f irstchar +2], points to one bit beyond the end of the 
top row of the missing character image. The offset of the image for an ASCII 
code / from the base address of the charpatn array is contained In 
loctable[/-firstchar]. The width of the image is calculated as w = 
(loctable[/-firstchar + 1 ] - (loctable[/-firstchar]. If the character 
represented by ASCII code / is missing from the table, the loctable member 
representing that character has the same value as the member for character /-I: 
loctable [/-f irstchar] = loctable [/-f irstchar + 1 ]. 

owtable [n] Offset/width table. The owtable array is a table of values giving the character 
offset and character width for each character in the font; the 8 MSBs of each 
member give the character offset, and the 8 LSBs give the character width. 
However, if an ASCII code / represents a character whose pattern is missing 
from the font, then owtable[/-f irstchar], the offset/width table entry for 
that character, is set to -1 (all Is). The owtable array contains entries only 
for ASCII characters f irstchar through last char, and also for the missing 
character. The owtable array has the same number of members as the 
loctable array. The offset/width value for the first character is contained In 
owtable [0]. The offset/width value for the last (nonmissing) character Is 
contained in owtable[lastchar-firstchar]. The offset/width value for 
the missing symbol is contained in owtable[lastchar-firstchar + 1 ]. 
The last member of the array, owtable[lastchar-f irstchar +2], contains 
a value of -1. 
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4.7 Available Fonts 

The math/graphics function library includes several fonts that can be used 
with the library's text functions. The TMS34010 Font Library provides addi¬ 
tional fonts (see the TMS34010 Font Library User's Guide). 

Figure 4-3 shows the five fonts that are included in the math/graphics func¬ 
tion library. 

CORPUS CHRIST! 16> The quick broen fox Junped over i 

CORPUS CHRISTI 29* The qu 
91 t © f Hh 

NORTH ROUE (30: The qiiicR brown f 

S4niflW0S21: 7hiac^uick. 

Figure 4-3. Five Fonts 


The font names are listed in Table 4-6 along with the font structure names that 
are used within a C program to install the font In the font table. 

Table 4-6. Installable Font Symbols 


Font Name 

Symbol Name 

CORPUS CHRISTI 16 

corpus—christil 6 

CORPUS CHRISTI 29 

corpus—christi29 

MONTROSE 28 

montrose28 

NORTH POLE 30 

north—pole30 

SAN MARCOS 21 

saTi—marcos21 


The program in Figure 4-4 draws the text display shown in Figure 4-3. 
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Show available fonts. 


V 

#include "fntstruc.h" 


/* Define FONT structure as data type. */ 


extern FONT corpus_christi29, 
inontrose28 , 
north—pole30, 
san—marcos21; 


/* Corpus Christ! font, size = 29 */ 
/* Montrose font, size = 28 */ 
/* North Pole font, size = 30 */ 
/* San Marcos font, size = 21 */ 


static char *cap[] = 
"CORPUS CHRISTI 
"MONTROSE 29: 

} ; 


{ 

16: ", "CORPUS CHRISTI 29: ", 

, "NORTH POLE 30: ", "SAN MARCOS 21: 


main() 

{ 

char *s; 
int X, y; 
int i; 


/* text */ 
/* text coordinates */ 
/* loop counter */ 


init—video(1); 
init—grafix(); 

init—text(); /* Corpus Christ! 16 selected as default font 
init—screen(); 

/* Remember the symbol! 

install—font(1, scorpus—Christi29); 
install—font(2, &montrose28); 
install—font(3, &north_pole30); 
install—font(4, &san—marcos21); 


V 

V 


s = "The quick brown fox jumped over the lazy sleeping dog.' 
for (i = 0, y = 50; i <= 4; ++i) { 

y += char—high(); /* 

select—font(i); 

y += char—high(); /* 

X = draw—string(0, y, cap[i]); 
draw—string(X, y, s); 


character height 
character height 


V 

V 


Figure 4-4. Drawing the Text Display for Figure 4-3 
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4.8 Graphics Output Functions 

The graphics functions draw several shapes in a variety of styles. Table 4-7 
describes the figure types and drawing styles. Table 4-8 shows which shapes 
can be drawn in a particular style. The column headers list the available styles 
and the row headers list the available shapes; a check mark indicates that a 
shape can be drawn with a particular style. Table 4-9 (page 4-17) describes 
the Individual graphics output functions. 

Table 4-7. List of Figure Types and Drawing Styles 


Figure Types 

Function Name 

Description 

bound 

Fill bounded set of pixels beginning at specified start point. 

line 

A straight line. 

oval 

Ellipse in standard position (major and minor axes parallel with 
coordinate axes). 

ovalarc 

An arc of an ellipse in standard position, specified in terms of be¬ 
ginning and ending angles. 

point 

A single pixel or pen image drawn at the indicated XY coordinate 
pair. 

polygon 

A filled region defined by a collection of straight edges. Both 
convex polygons and arbitrarily complex polygons are supported. 

polyline 

A collection of straight lines. Figures made up of many lines can 
be drawn more efficiently by using the polyline commands than 
by repeated calls to the line functions. 

piearc 

Pie arc or wedge. Similar to ovalarc, but with addition of sides 
drawn from center of ellipse to arc endpoints to produce closed 
figure. 

rect 

Rectangle with vertical and horizontal sides. 

seed 

Fill connected set of pixels beginning at specified seed point. 

Drawing Styles 

Function Name 

Description 

draw 

Draws figure outline one pixel wide using COLOR1. 

fill 

Draws figure interior filled in solid C0L0R1. 

frame 

Draws frame In solid C0L0R1. Horizontal and vertical thicknesses 
of frame border are both specified. 

patnframe 

Draws frame using pattern in COLORO and C0L0R1. Horizontal 
and vertical thicknesses of frame border are both specified. The 
16-by-16 pattern is programmable. 

patnpen 

Draws figure outline using pen and pattern in COLORO and 
COLOR1. Pen Size and 16-by-16 pattern are programmable. 

pen 

Draws figure outline using pen in solid COLOR1. Pen Is rectan¬ 
gular with programmable height and width. 

patnfill 

Draws figure Interior filled with pattern in COLORO and C0L0R1. 
The 16-by-16 pattern is programmable. 
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Table 4-8. Checklist of Available Figure Types and Drawing Styles 



Drawing Style 

Figure 

Type 

draw 

pen 

patnpen 

fill 

patnfill 

frame 

patnframe 

bound 




V 

V 



line 

V 

V 

V 





oval 

V 



V 

V 

V 

V 

ovalarc 

V 

V 

j 





piearc 

V 

V 

sj 

V 

V 



point 

V 

V 

V 





polygon 




V 

V 



polyline 

V 

V 

V 





rect 

V 



V 

V 

V 

V 

seed 




V 

V 




Table 4-9. Summary of Graphics Output Functions 


Function Name 

Description 

bound—fill 

Fills a bounded set of pixels given a starting point and a boundary 
color. 

bound—patnfill 

Fills a bounded set of pixels with the current pattern given a 
starting point and a boundary color. 

draw—line 

Draws a straight line one pixel thick. 

draw—oval 

Draws the outline of an ellipse. The outline is one pixel In thick¬ 
ness. 

draw—ovalarc 

Draws an elliptical arc one pixel thick. 

draw—piearc 

Draws the outline of a pie slice of an ellipse. The outline is one 
pixel thick. 

draw—point 

Draws a pixel at the specified coordinates. 

draw—polyline 

Draws a list of lines one pixel thick. 

draw—rect 

Draws the outline of a rectangle. The sides are one pixel In thick¬ 
ness. 

fill—convex 

Fills a convex polygon. 

fi||_oval 

Draws a solid-filled ovalangle. 

fill—piearc 

Draws a solid-filled pie slice of an ellipse. 

fill—polygon 

Draws a solid-filled polygon given a list of edges. 

fill—rect 

Draws a solid-filled rectangle. 
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Table 4-9. Summary of Graphics Output Functions (Concluded) 


Function Name 

Description 

frame—oval 

Draws an elliptical frame of specified thickness. The frame border 
is solid-filled. 

frame—rect 

Draws a rectangular frame of specified thickness. The frame border 
is solid-filled. 

patnfill—convex 

Fills a convex polygon with the current pattern. 

patnfill—oval 

Draws an ellipse filled with the current pattern. 

patnfill—piearc 

Draws a pattern-filled pie slice of an ellipse. 

patnfill—polygon 

Draws a pattern-filled polygon given a list of edges. 

patnfill—rect 

Draws a rectangle filled with the current pattern. 

patnframe—oval 

Draws an elliptical frame of specified thickness. The frame border 
is filled with the current pattern. 

patnframe—rect 

Draws a rectangular frame of specified thickness. The frame border 
is filled with the current pattern. 

patnpen—line 

Draws a straight line using the drawing pen and the current pat¬ 
tern. 

patnpen—ovalarc 

Draws an elliptical arc using the drawing pen with the current 
pattern. 

patnpen—piearc 

Draws the outline of a pie slice of an ellipse using the drawing pen 
and the current pattern. 

patnpen—point 

Draws the pen with the current pattern at the specified coordi¬ 
nates. 

patnpen—polyline 

Draws a list of lines using the drawing pen and the current pattern. 

pen—line 

Draws a straight line using the drawing pen. 

pen—ovalarc 

Draws an elliptical arc using the drawing pen. 

pen—piearc 

Draws the outline of a pie slice of an ellipse using the drawing 
pen. 

pen—point 

Draws the pen at the specified coordinates. 

pen—polyline 

Draws a list of lines using the drawing pen. 

seed—fill 

Fills a connected set of pixels given a seed point. 

seed—patnfill 

Fills a connected set of pixels with a pattern given a seed point. 

styled—line 

Draws a styled line using the specified 32-bit line-style pattern. 
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4.9 Graphics Attribute Control Functions 

These functions allow you to select and enable a variety of graphics attributes, 
including: 

• Foreground (C0L0R1) and background (COLORO) colors, 

• Pixel transparency, 

• Pixel processing operation code, 

• Plane mask, 

• Pen width and height, and 

• 16x16 fill pattern. 

Table 4-10 summarizes these functions. Refer to the TMS34010 User's Guide 
for descriptions of COLORO, COLOR1, transparency, pixel processing, and the 
plane mask. 

Table 4-10. Summary of Graphics Attribute Control Functions 


Function Name 

Description 

get—patn—max 

Gets the maximum number of patterns that can be installed in 
pattern table at one time. 

get—pmask 

Gets the current plane mask. 

get—ppop 

Gets the current pixel processing option. 

get—psize 

Gets the current pixel size. 

get—transp 

Gets the current transparency flag. 

install—patn 

Installs a new pattern in pattern table. 

select—patn 

Selects a pattern that is already installed in pattern table. 

set—GolorO 

Sets the background color used for text, bitmap expansion, and 
patterns. 

set— CO lor 1 

Sets the foreground drawing color used for vectors, fills, text, bit¬ 
map expansion and patterns. 

set—pensize 

Sets the width and height of rectangular drawing pen. 

set—ppop 

Sets the pixel processing operation code. 

set—pmask 

Sets the plane mask, enabling or disabling individual color planes 
as specified. 

transp—off 

Disables the pixel attribute of transparency. 

transp—on 

Enables the pixel attribute of transparency. 
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4.10 Fill Patterns 

Graphics functions which include pain as part of their names draw with a 
pattern instead of a solid color. The pattern Is specified as a 16x16 bitmap, 
and is represented in memory as an array of 256 contiguous bits. The bits in 
a pattern are listed in left-to-right order within a row, and rows listed in top- 
to-bottom order. You must Install a pattern in the library's pattern table before 
you call a function that draws with the pattern. 

Figure 4-5 shows an example of a pattern as it appears on the screen. The 
small squares represent individual bits in the pattern; shaded squares represent 
Is and white squares represent Os. The bit at the top left corner Is the first bit 
(bit 0) in the pattern array. The bit at the lower right hand is the last bit (bit 
255) in the array. 



I I I I I I I i I I I I I I 

I I I i I I i I I I I I I I 


Figure 4-5. A 16x16 Pattern 


When a pattern is drawn to the screen, the Os In the bit map are replaced with 
COLORO, and the Is In the bit map are replaced with COLOR1. The pattern 
is mapped into 16x16 cells on the screen. The X and Y coordinates at the top 
left corner of each cell are both multiples of 16. 

The library supports several patterns that are installed as the default patterns 
when the init—grafix function is called. You can view the default patterns by 
executing the program shown in Figure 4-6. 
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Show available patterns in deck-of-cards display. 


V 

main() 

{ 

int X, 


y, dx, dy, i, hueO, huel; 


init—video(1); 

init—grafix(); /* Initialize default patterns, 

init—screen(); 
i = get—patn_max(); 
dx = 480 / i; 
dy = 3^0 / i; 

X = y = 0; 
hueO = huel = 0; 

for (—i; i >= 0; --i, x += dx, y += dy) { 
select_patn(i); 

set—colorO(rep—pixel(hue0++)); 
set—color1(rep—pixel(—huel)); 
patnfill—rect(160, 160, x, y); 

} 


} 


V 


Figure 4-6. Program for Displaying the Default Patterns 


You can use the install—patn function to install your own pattern in any po¬ 
sition in the pattern table. The program in Figure 4-7 installs and displays the 
pattern shown in Figure 4-5. 
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Install a pattern in the pattern table. 


V 

main() 

{ 


typedef enum { FIELDWIDTH = 
static BIT mypatn[] = { 

0,0,0,0,0,0,0,0,0,0,0,C 
0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 ,] 
0,1,1,1,1,1,1,1,1,1,1,] 
0,1,1,0,0,0,0,0,0,0,0,c 

0,1,1,0,0,0,0,0,0,0,0,C 
0,1,1,0,0,0,1,1,1,1,1,] 
0,1,1,0,0,1,1,1,1,1,1,] 
0,1,1,0,0,1,1,0,0,0,0,C 
0,1,1,0,0,1,1,0,0,0,0,C 
0,1,1,0,0,1,1,1,1,1,0,C 
0,1,1,0,0,0,1,1,1,0,0,C 
0,1,1,0,0,0,0,0,0,0,0,C 
0,1,1,0,0,0,0,0,0,0,0,C 
0,1,1,1,1,1,1,1,1,1,1,] 
0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 ,] 
o,o,o,o,o,o,o,o,o,o,o,c 

} ; 

init—video (1) ; 

init—graf ix () ; 

init—screen(); 

install—patn(5, mypatn); 

set—colorO(rep—pixel(4)); 

set—color1(rep—pixel(7)); 

patnfill—oval(448, 288, 96, 


1 } BIT; 

, 0 , 0 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 1 , 0 , 
, 0 , 0 , 0 , 0 , 
, 0 , 0 , 0 , 0 , 
, 1 , 0 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 1 , 0 , 0 , 
. 1 , 0 , 0 , 0 , 
, 0 , 0 , 0,0 


/* Installs default patterns. */ 

/* Assign index =5. */ 
/* Expand Os to this color. */ 
/* Expand Is to this color. */ 
96) ; 


Figure 4-7. Program for Installing Fonts 
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4.11 Color Palette Functions 

These functions allow you to read and modify the color lookup table that is 
used to translate pixel values Into colors on the screen. In systems that sup¬ 
port color indexing, the color associated with each possible pixel value Is 
specified in the corresponding entry in a color lookup table. The colors seen 
on the display are generated by using the pixel values from the display memory 
as Indices into the lookup table. Each table entry specifies the red, green, and 
blue intensities that make up the color. 

The color lookup table Is loaded into the Internal registers of a color-palette 
device such as a TMS34070 color-palette chip. The driver routines that im¬ 
plement the palette functions are necessarily device dependent. The imple¬ 
mentation that runs on the TMS34010 Software Development Board assumes 
a pixel size of four bits and a TMS34070 color palette that is configured In 
line-load mode. The set—palet function changes the color associated with a 
specified pixel value, and is relatively easy to emulate in systems containing 
other types of palette devices. More difficult to emulate are the functions 
which make use of the ability of the TMS34070 color-palette chip to load its 
registers with a new lookup table at the beginning of each scan line In the 
frame. With this ability, a different color palette can be assigned to each scan 
line or group of scan lines. Three functions use this feature of the TMS34070 
color palette: setall—palet, getall—palet and color—blend. 

Refer to the TMS34070 User’s Guide for information about the TMS34070 
color palette. Refer to the TMS34010 Software Development Board User’s 
Guide for Information on configuring the palette on the SDB to operate in 
line-load mode. 


Table 4-11 summarizes the color palette functions. 

Table 4-11. Summary of Color Palette Functions 


Function Name 

Description 

color—blend 

Creates gradual changes in shading, highlights, and color blending 
effects by gradually varying the red, green and blue Intensities of 
the color associated with a specified pixel value on a line-by-line 
basis. 

getall—palet 

Reads multiple registers of the TI\/1S34070 color palette. The pal¬ 
ette for the specified scan line Is returned. 

set—palet 

Changes the color that is associated with a specified pixel value. 

setall—palet 

Loads multiple registers of the TMS34070 color palette. The pal¬ 
ette is affected only over a specified group of scan lines. 
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4.12 Pixel and Pixel Array Manipulation Functions 

These functions copy and process individual pixels and two-dimensional ar¬ 
rays of pixels. (2D pixel arrays correspond to rectangular areas of the screen.) 
Table 4-12 summarizes the pixel array functions. 

Table 4-12. Summary of Pixel Array Functions 


Function Name 

Description 

bit—expand 

Expands a bitmap to the specified rectangular area of the screen. 
The expansion process replaces the 1 s in the bitmap with COLOR1 
and replaces the Os with COLORO. 

get—pixel 

Returns the value of the specified pixel on the screen. 

get—rect 

Captures a rectangular area of the screen into the specified pixel 
array. 

move—pixel 

Copies a pixel from one screen location to another. 

move—rect 

Copies the pixels in a rectangular area of the screen to another 
rectangular area of the same size. 

put—pixel 

Copies the specified value to the specified pixel on the screen. 

put—rect 

Copies an array of pixels to a rectangular area of the screen. 

run—decode 

Decompresses a previously run-length encoded image and copies 
the Image to a specified location on the screen. 

run—encode 

Uses run-length encoding to compress an image contained In a 
specified rectangular area of the screen. 

zoom—rect 

Zooms the pixels in the specified source rectangle on the screen 
to fit the specified destination rectangle on the screen. 
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4.13 Viewport Management Functions 

These functions allow you to change the position and size of a viewport. They 
also allow you to change the relative origin and clipping rectangle associated 
with the viewport. 

A viewport is a rectangular area of the screen; drawing can occur within the 
boundaries of a viewport. Multiple viewports can be open simultaneously, but 
only one viewport Is active at a time. Drawing operations can take place only 
within the active viewport. All graphics output is automatically clipped so that 
only pixels lying inside the boundaries of the viewport are drawn. 

When a viewport Is moved or resized, anything previously drawn to the screen 
Is not affected; changes in the viewport do affect subsequent drawing oper¬ 
ations. Similarly, when the relative origin is moved, or the clipping rectangle 
is changed, only subsequent drawing operations are affected. 

Figure 4-8 shows an example in which two viewports, 0 and 6, are open. A 
relative XY origin and a clipping rectangle are associated with each viewport 
in Figure 4-8. All graphics output is drawn in the coordinate system defined 
by the relative origin associated with the active viewport. The clipping rec¬ 
tangle allows you to restrict drawing to a rectangular region within the view¬ 
port. Drawing can occur only in the visibility rectangle represented by the 
intersection of the active viewport, the clipping rectangle associated with that 
viewport, and the screen. 


screen origin 



Applications that do not require viewports, clipping rectangles, or relative ori¬ 
gins can ignore them. The init—grafix function establishes a default viewport 
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for which the visibility rectangle is the entire screen. It also positions the XY 
origin at the top left corner of the screen. Applications that use viewports, 
clipping rectangles, or relative origins must call the init—vuport function before 
calling any of the viewport functions. 

A set of graphics and text attributes are associated with each open viewport. 
When a viewport is activated, the state of these attributes at the end of the 
previous activation (of the same viewport) Is automatically restored. The fol¬ 
lowing is a list of attributes associated with each viewport: 

• The viewport width and height and the XY coordinates of Its top left 
corner (specified as displacements from the top left corner of the 
screen). 

• A relative origin that Is specified in terms of Its X and Y displacements 
from the top left corner of the viewport. 

• A clipping rectangle that is specified in terms of Its width and height, 
and the XY coordinates at Its top left corner, relative to the viewport's 
relative origin. 

• A pattern index that indicates the current pattern. 

• A font index that Indicates the current font. 

• A text horizontal spacing increment that indicates the amount by 
which the default spacing between characters is modified. The incre¬ 
ment can be positive, negative, or zero. (See the add—text—space 
function.) 

• The current width and height of the drawing pen. 

• The current CO LORO that defines the background color specified for 
text and pattern drawing. 

• The current COLOR1 that defines the foreground color specified for text 
and pattern drawing, and the drawing color used for lines, solid fills, and 
so on. 

• The current pixel processing operation code that Identifies one of the 
22 pixel processing operations performed by the TMS34010. 

• A transparency flag that indicates whether the pixel transparency at¬ 
tribute is currently enabled or disabled. 

• The current plane mask that indicates which color planes are enabled 
and disabled during graphics output operations. 

When you move a viewport, you must specify the viewport's new position (as 
measured from its top left corner) relative to the screen origin, which lies at 
the top left corner of the screen. When you move the viewport's relative XY 
origin, you must specify the new origin in terms of its X and Y displacements 
from the top left corner of the viewport. When the viewport position is 
changed, the relative origin moves with it. The position of the clipping rec¬ 
tangle Is defined in terms of the relative origin. When the position of either the 
viewport or the relative origin is changed, the position of the clipping rectan¬ 
gle moves accordingly. 

Table 4-13 summarizes the viewport management functions. 
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Table 4-13. Summary of Viewport Management Functions 


Function Name 

Description 

close—vuport 

Closes a viewport that was previously opened. 

copy—vu port 

Copies the attributes from one viewport to another. Both view¬ 
ports must be open. 

cpw 

Compares point to window and returns 4-bit outcode. 

get—vuport—max 

Gets maximum number of viewports that can be open at once. 

in it—vuport 

Initializes the viewport data structures, and opens the system 
viewport as viewport 0. 

move—vuport 

Moves the viewport to a new position on the screen. The position 
is specified in terms of X and Y displacements from the top left 
corner of the screen. 

open—vuport 

Opens a new viewport. 

select—vuport 

Activates a viewport that is already open. 

set—cliprect 

Sets the clipping rectangle to the specified width and height, and 
moves it to the specified position. The position is specified in 
terms of X and Y displacements from the viewport-relative origin. 

set—origin 

Sets the XY origin for the viewport to the new position. The po¬ 
sition is specified in terms of X and Y displacements from the top 
left corner of the viewport. 

size—vuport 

Changes the width and height of a viewport as specified. The 
position of the top left corner of the viewport remains fixed while 
the bottom right corner is adjusted to accommodate the new di¬ 
mensions. 
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4.14 Miscellaneous Functions 


Table 4-14 summarizes the functions that are not described in the previous 
categories. 

Table 4-14. Summary of Miscellaneous Functions 


Function Name 

Description 

delay 

Delays the specified number of ticks (tick = 1/60 second). 

lib—id 

Gets character string specifying current revision of function library. 

Imo 

Returns the bit number of the leftmost one in the 32-bit argument. 

peek 

Fetches a 16-bit word from the specified address in memory. 

peek—breg 

Reads the contents of a specified 32-bit B-file register. 

poke 

Pokes a 16-bit word into the specified address in memory. 

poke—breg 

Loads a specified B-file register with a 32-bit value. 

rep—pixel 

Replicates a pixel value throughout a 32-bit integer. 

rmo 

Returns the bit number of the rightmost one in the 32-bit argu¬ 
ment. 

wait—scan 

Waits until the electron beam has finished scanning the specified 
horizontal line of the CRT. 

xytoaddr 

Converts viewport-relative XY coordinates to 32-bit memory ad¬ 
dress of a pixel. 
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4.15 Special Data Formats 

The library's graphics functions use the following four data formats: 

• Transformation matrix, 

• Vertex list, 

• Point list, and 

• Line list. 

These four data formats specify the organization of information that is passed 
between the function library routines and an application program. They differ 
from the text font storage structure described earlier, which is managed auto¬ 
matically by the text functions. The transformation matrix, vertex list, point list, 
and line list are described in the following paragraphs. 

4.15.1 Transformation Matrix 

The transformation matrix is a 4x4 matrix that is stored in a 16-element array 
of 32-blt fixed-point values. The 32-bit fixed-point format places the 16 LSBs 
to the right of the binary point, partitioning the value into a 16-bit 2s-com- 
plement integer Matrix elements are mapped into the array in row major order, 
as illustrated In Figure 4-9. 


ao,0 

30,1 

30,2 

30,3 

matrlx[0] 

= 3 0,0 

matrix[8] = 

32,0 

matrix[1 ] 

= 30,1 

matrlx[9] = 

32.1 

ai.O 

31,1 

31,2 

31,3 

matrix[2] 

= 3 0,2 

matrix[10] = 

32,2 

matrix[3] 

= 30,3 

matrix[11 ] = 

32,3 

32.0 

32,1 

32,2 

32,3 

matrlx[4] 

= 3 1,0 

matrix[12] = 

33,0 

matrix[5] 

= 31,1 

matrix[13] = 

33,1 

33,0 

33,1 

33,2 

33,3 

matrlx[6] 

= 3 1,2 

matrix[14] = 

33,2 


matrix[7] 

= 31,3 

matrix[15] = 

33,3 


Figure 4-9. Transformation Matrix Format 


4.15.2 Vertex List 

The vertex list is an array of values that represent a collection of points in 
three-dimensional space. Each point is specified In terms of Its X, Y, and Z 
coordinates. Each coordinate is represented as a 32-bit fixed-point value. 
Figure 4-10 illustrates the vertex list format. The X, Y, and Z coordinate values 
for a point k are stored In vertex-list array elements 2k, 3/r+1 and 2k+2, 
respectively. An array that specifies N vertices must contain 3N 32-bit fixed- 
point elements, each of which is a coordinate value. 
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typedef long FIX; 


/* 

32-bit 

f ixed- 

-point type 

V 

FIX x[N], y[N], z[N]; 
FIX vertex-list[3*N]; 


/* 

/* 

/* 

x,y,z 
0, 1, 
vertex 

values 

2, . . . 

list 

for 

vertices */ 

V 

V 

vertex—list[0] = x[0] 
vertex—list[1] = y[0] 
vertex—list[2] = z[0] 


/* 

x,y,z 

coords 

for 

point 

0 */ 

vertex—list[3] = x[l] 
vertex—list[4] = y[l] 
vertex—list[5] = z[l] 


/* 

x,y,z 

coords 

for 

point 

1 V 

vertex—list[6] = x[2] 
vertex—list[7] = y[2] 
vertex—list[8] = z[2] 


/* 

x,y,z 

coords 

for 

point 

2 V 

vertex—list[3k] = x[k]; 
vertex—list[3k+l] = y[k]^ 

vertex—list[3k+2] = z[k], 

/* 

x,y,z 

coords 

for 

point 

k */ 


Figure 4-10. Vertex List Format 


4.15.3 Point List 

The point list is an array of values representing a collection of points in two- 
dimensional space. Each point is specified in terms of its X and Y coordinates. 
Each coordinate is represented as a 16-bit integer (C type short). Figure 4-11 
illustrates the point list format. The X and Y coordinate values for a point k 
are stored in point-list array elements 2k and 2/r+1 , respectively. An array 
specifying N points must contain 2N 16-bit integer elements, each of which 
is a coordinate value. 



Figure 4-11. Point List Format 
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4.15.4 Line List 

The line list is an array of values that represent a collection of straight lines. 
Each element of the line list array is an index into a point list (described in 
Section 4.15.3). The line list contains the topology information for a graphics 
object and specifies which pairs of points are connected by the lines (if wir¬ 
eframe) or edges (if solid) of the object. Each line in the line list is represented 
by two adjacent elements. The first element is an index specifying the starting 
point for the line, and the second element is an index specifying the ending 
point. Each index is a 16-bit integer (C type short). 

Figure 4-12 illustrates the relationship between the line list and point list for¬ 
mats. The example contains a wireframe figure that is made up of four lines. 
The indices for the starting and ending points of a line k are stored in 
line—list array elements 2k and 2/:+1, respectively. An array that specifies n 
lines must contain 2n 16-blt Integer elements, each of which is an index into 
a point list. The figure shown in Figure 4-12(a) can be drawn using the fol¬ 
lowing function call: 

draw—polyline(6, line—list, point—list) 

Figure 4-12 (b) shows the mapping of the data for the figure in Figure 
4-12(a) to the line-list and point—list arrays. For example, line LO is 
defined in the line list as having end points PO and PI. Points PO and PI are 
defined in the point list as having coordinates (xO,yO) and (x1,y1). 

If line-list array elements 2k and 2/r+1 contain index values n and m, re¬ 
spectively, the line is drawn from point n to point m of the point list array. 
Point list elements 2n and 2a7+1 contain the two coordinates of point n, 
(xn,yn). Similarly, the two coordinates of point m, (xm,ym), are stored In 
point list elements 2m and 2/7?+1. 
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point list: 
PO = 
P1 = 
P2 = 
P3 = 


(Xo.Vo) 
(x. .yJ 
1^2.Vaj 

(xa.Va) 


line list: 

LO = (PO.PD 
L1 = (P1,P2) 
L2 = (P2,P3) 
L3 = (P3,P0) 
L4 = (P0,P2) 
L5 = (P1,P3) 


(a) A Wireframe Figure 


LO 

L1 

L2 

L3 

L4 

L5 

(b) Mapping Data from the Wireframe into the 
line—list and pt—list Arrays 

Figure 4-12. Line List Format 
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4.16 Mapping Pixels to XY Coordinates 

Figure 4-13 illustrates the conventions that are used to map XY coordinates 
to pixels on the screen. The filled area is a rectangle of width w=5 and height 
h=3 whose top left corner is located at XY coordinates (4,2). The fill is per¬ 
formed by the following function call: 

fill-rect(5, 3, 4, 2) 

Pixels lying within the perimeter of the specified rectangle are "turned on" to 
represent the fill area. By convention, X increases from left to right, and Y in¬ 
creases from top to bottom. The default origin is at the upper left corner of the 
screen. (The origin may be relocated at an arbitrary position on or off screen 
by means of a call to the set—origin function.) The XY coordinates passed to 
graphics routines are constrained to be integer values. The coordinate grid is 
overlayed on the screen such that integer XY coordinate pairs coincide with 
pixel corners (not with pixel centers). The conventions used for determining 
which pixels are selected to represent filled areas and Infinitely thin vectors are 
explained in the following discussion. 


0 

4 9 

^-i 




OOOOD 

000(X) 

OOOCX) 

h = 3 

o 


-w = 5-► 



y 


Figure 4-13. Rectangle Fill 


4.16.1 Area Filling Conventions 

Figure 4-14 shows a complex filled area. In this case, a fill—polygon com¬ 
mand defines the fill area indicated by the straight edges in the figure. The rule 
for determining whether a pixel is selected as part of the fill area is as follows. 
If the center of the pixel falls within the mathematical boundary of the area, it 
is "turned on" to indicate that it is part of the fill area. (If a pixel's center falls 
precisely on the boundary between two areas, by convention the pixel is 
considered to be part of the area immediately below and to the right of the 
pixel). Pixels whose centers lie outside the boundary are not considered part 
of the fill region. The same principles are applied to the filling of other shapes 
(ellipses and thick lines drawn with a rectangular drawing pen, for example). 

Graphics functions that follow the above conventions for filled areas include 
all functions whose names include the modifiers fill, pen, or frame. 
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y 


Figure 4-14. Polygon Fill 


4.16.2 Vector Drawing Conventions 

Points, lines, and arcs are defined mathematically to be Infinitely thin. Since 
these figures contain no area, they are invisible if drawn using the conventions 
described above for filled areas. A different set of conventions must be used 
to make points, lines, and arcs visible. These are referred to as vector drawing 
conventions (to distinguish them from the area filling conventions discussed 
previously). Vector drawing conventions apply to all functions whose names 
include the modifier draw. 

The vector drawing conventions associate the point identified by the Integer 
coordinate pair (X,Y) with the pixel located to its lower right; that is, the pixel 
whose center is located at coordinates (X+1/2,Y+1/2). For example, the 
draw—point(7,10) command turns on the pixel at (7.5,10.5). As a second 
example, the polygon from Figure 4-14 Is shown again In Figure 4-15, but is 
outlined rather than filled. (The draw—polyline function is used.) The points 
selected to represent the right side of the polygon are Indicated as small black 
dots. The pixel to the lower right of each point is turned on to represent the 
edge of the polygon. 

A line or arc drawn using the vector drawing conventions consists of a con¬ 
nected set of pixels. This means that the line or arc is drawn as a continuous 
set of pixels that connect (or touch) horizontally, vertically or diagonally, 
without gaps or holes in between. 


4-33 







Graphics and Text Functions - Mapping Pixels to XY Coordinates 



X 


Figure 4-15. Polygon Outline 


4.16.3 The Drawing Pen 

The drawing commands that use vector drawing conventions can only draw 
lines and arcs that are a single pixel thick. To draw lines and curves of arbi¬ 
trary thickness, a rectangular pen (or brush or logical pel) is used. Graphics 
functions that use the drawing pen have names containing the modifier pen. 

You can use graphics commands to set the drawing pen's height and width 
to arbitrary positive, nonzero values. The pen is rectangular; its position is 
identified by its top left corner. For example, when a pen of width w and 
height h draws a point at (X,Y), the resulting rectangle's top left corner lies at 
(X,Y), and its bottom right corner lies at (X+w,Y+h). The rectangular area 
covered by the pen Is filled with either a solid color or with the current pattern, 
depending on the function used. 

The area under the drawing pen Is filled according to the area filling con¬ 
ventions described previously. When the width and height of the drawing pen 
both equal 1, a line or arc drawn by the pen is similar in appearance to that 
drawn by a function following the vector drawing conventions. However, the 
pen functions conform to the area filling conventions, so a pen function can 
more faithfully track the perimeter of a filled area than a corresponding draw 
function. For example, consider an ellipse defined by some width w, height 
h, and coordinates (x,y), If a draw—oval(w,h,x,y) function call outlines a filled 
ellipse drawn by a fill—oval(w,h,x,y) function, the draw—oval function may 
not in all instances select the same perimeter pixels as the filled ellipse. This 
can leave gaps between the filled area and the outline. In contrast, a 
pen—oval(w,h,x,y) function call follows the filled ellipse precisely, remaining 
flush to the ellipse at all points along the perimeter. 
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4.17 System Implementation issues 

Most of the functions in the library are independent of system-dependent 
features such as pixel size and frame buffer dimensions. However, imple¬ 
mentations of hardware functions such as the color palette, video timing, and 
bulk clearing of VRAMs necessarily differs from system to system. The func¬ 
tion library provides several system-dependent functions to control such fea¬ 
tures. 

4.17.1 Register Usage Conventions 

Assembly language functions that are used in conjunction with the graphics 
functions should follow certain guidelines for register use. The following 
registers must be restored to their original states (the state before the function 
was called) before control is returned to the calling routine: 

• Status register fields FE1 and FS1 must be restored. Fields FEO and FSO 
need not be restored. 

• All A-file registers except A8 must be restored. 

• In general, all B-file registers must be restored. However, certain B-file 
registers may be altered by attribute control functions that update pa¬ 
rameters such as COLORO and COLOR1. 

• In general, I/O registers CONTROL, DPYCTL, CONVSP, and CONVDP 
should be restored before returning to the calling routine. However, 
some I/O register bits may be altered by attribute control functions that 
update parameters such as the plane mask, pixel processing operation, 
or transparency flag. These register bits typically are not changed by 
graphics output functions. 

Upon entry to a function, certain registers are In a known state and contain 
well-defined parameters. Assume that the following registers are in these 
states: 

• Status register. The C environment always leaves the FE1 and FS1 
fields defined as follows: 

FE1 = 0 
FS1 = 32 

FEO and FSO are undefined. 

• B-file registers. Seven of the B-file registers are In a known state 
when a function is entered: 

~ SPTCH - pitch of selected font. 

- DPTCH - screen pitch (difference In starting memory addresses of 
any two successive scan lines in display memory). 

- OFFSET - memory address of pixel at top left of screen. 

~ WSTART - top left corner of current visibility region. 
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- WEND - bottom right corner of current visibility region. 

- COLORO - source background color for PixBIts (text and pattern 
fills). 

- COLOR1 - source foreground color for PixBIts, fills and vectors. 

• I/O registers. Certain I/O registers contain defined parameters at entry 
to a function: 

- CONTROL - contains current pixel processing operation code and 
transparency control bit. These are set by the application program 
and may vary from one call to the next. In contrast, the window 
mode, PBH and PBV bits are set to specific values. The window 
mode Is set to enable clipping without Interrupts (W=3). The PBH 
and PBV bits are both zero. 

CONVSP “ Is set up for the pitch of the selected font. 

“ CONVDP - Is set up for the screen pitch. 

- PSIZE - the number of bits per pixel on the screen. 

PMASK - contains the current plane mask. 

4.17.2 Functions with System Dependencies 

The current Implementation of system-dependent library functions supports 
the TMS34010 Software Development Board. System-dependent aspects of 
the SDB are chiefly due to the special capabilities of the VRAM and color- 
palette device that are used on the SDB. The TMS4161 or TMS4461 video 
RAMs used on the SDB are capable of bulk clearing the frame buffer, but vi¬ 
deo RAMs from other manufacturers may not support the register-to-memory 
cycles necessary to Implement this feature. (The bulk clear capability Is de¬ 
scribed in the TMS34010 User's Guide.) Also, the TMS34070 color palette 
provides color indexing for displays using four bits per pixel. The TMS34070 
Is capable of loading a new lookup table prior to each scan line of the display, 
and this permits the color palette to be changed on a line-by-line basis. 
Comparable devices from other manufacturers may not provide this capability. 

Table 4-15 is a list of library routines that perform system dependent func¬ 
tions. If a routine is not listed, assume that It Is not system dependent. 
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Table 4-15. Functions with System Dependencies 


Function 

System Dependency 

clear—screen 

Uses the TMS34070 color palette; uses the bulk clear capability of the 
TI\/IS4161 video RAM. 

color—blend 

Uses the TMS34070 color palette. 

getall—palet 

Uses the TMS34070 color palette. 

init—palet 

Uses the TMS34070 color palette. 

in it—screen 

Uses the TMS34070 color palette; uses the bulk clear capability of the 
TMS4161 video RAM. 

init—video 

Initializes video timing and screen refresh registers. 

new-screen 

Uses the TMS34070 color palette; uses the bulk clear capability of the 
TMS4161 video RAM. 

set—palet 

Uses the TMS34070 color palette. 

setall—palet 

Uses the TMS34070 color palette. 


4.17.3 Uninitialized System Parameters 

The function library assumes that certain system parameters are under control 
of an operating system or control program, and avoids initializing or modifying 
these parameters. Specifically, library functions do not alter the following 
hardware registers: 

• The master interrupt enable bit (IE) in the status register 

• The INTENB (interrupt enable) register 

• The cache disable bit (CD) in the CONTROL register 

• The DRAM-refresh control bits (RR and RM) in the CONTROL register 

• The four host interface registers (HSTADRL, HSTADRH, HSTDATA, and 
HSTCTL) 

4.17.4 Interrupts 

The assembly language routines within the library use the TMS34010's A14 
register as a general-purpose register. Interrupt service routines should make 
no assumptions regarding the state of A14 at the time an interrupt occurs. In 
particular, they should not assume that A14 points to the top of the C param¬ 
eter stack. 

The library does not use Interrupts. A number of graphics functions in the li¬ 
brary make use of the window violation detection capabilities of the 
TMS34010, but they assume that the WV interrupt Is disabled. 

Similarly, the library's wait—scan and delay functions poll the display Interrupt 
request, but assume that the display interrupt is disabled. An operating envi¬ 
ronment or application program that includes a display Interrupt service rou¬ 
tine may have difficulty using these two functions as currently Implemented. 
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Section 5 


Alphabetical Reference of Functions 


This section contains a reference of the math/graphics function library. The 
discussions are organized into alphabetical order; each discussion begins on 
a new page so you easily can find each function. Each discussion: 

• Shows the syntax of the function declaration and arguments that the 
function uses. 

• Contains a description of the function operation, which explains any 
input arguments and return values. 

• Provides an example that uses the function. 


Note: 

All of the functions can be called from a C program except for these 
functions: 

FIX2FL 

FL2FIX 

FL-ADD 

FL-COS 

FL_MULT 

FL-SIN 
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acos 

Syntax 

Description 


Example 


Arc Cosine Function 


double acos(x) 
double x; 

The acos function calculates the inverse cosine of a double-precision 
floating-point number. Both the argument x and the return value are 
double-precision floating-point numbers. 

The return value is an angle expressed in radians: 

• If X is in the range [-1,1], the return value is in the range [0,n]. 

• If X is outside the range [-1,1], fp—error is called with error code = 

18 (see the description of the floating-point facility in TMS34010 
C Compiler User's Guide). 

• If X > 1, a value of +oo is returned. 

• If X < -1, a value of -oo is returned. 


/*******************************************/ 
/* acos returns value expressed in radians */ 

/*******************************************/ 
extern double acos(); 
double realval, radians; 

realval = 1.0; 

radians = acos(realval); 

return (radians); /* acos returns n/2 */ 
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add—text—space 


Syntax 


Description 


Example 


void add—text—space(n) 

int n; /* Add n to default spacing */ 

/* between characters */ 

The add—text—space function changes the horizontal spacing between 
characters by an amount n. Associated with each text font is a default 
spacing between a character and the character to its right. When a string 
of characters is drawn to the screen, n is added to the default spacing 
between characters defined in the data structure for the current font. Ar¬ 
gument n is specified in multiples of the pixel width; it can be positive or 
negative, depending on whether you wish to increase or decrease the 
spacing. 

Once text spacing is modified by the add—text—space function, the spac¬ 
ing increment remains in effect (within the viewport) until this function 
is called again. The init—text function sets the spacing increment to its 
default value, 0. 


Note: 

Before you call the add—text—space function, call the init—text function 
to initialize the text data structures. 


short X, y, i; 
char *s; 

init—video(1); 
init—grafix(); 
init—screen(); 
init—text(); 

s = "Note increasing space between characters."; 
for (i = -8, y = 0; i < 20; ++i) { 

add—text—space(i); 

X = 320 - get—width(s)/2; 
y += char—high(); 
draw—string(X, y, s) ; 

} 





asin 


Arc Sine Function 


Syntax 

Description 


Example 


double asin(x) 
double x; 

The asin function calculates the inverse sine of a double-precision float¬ 
ing-point number. Both the argument x and the return value are dou¬ 
ble-precision floating-point numbers. 

The return value Is an angle expressed in radians. 

• If X is in the range [-1,1], the return value is in the range 
[-n/2,+n/2]. 

• If X is outside the range [-1,1], fp—error is called with error code = 
18 (see the description of the floating-point facility in TMS34010 
C Compiler User's Guide). 

• If X > 1, a value of +oo is returned. 

• If X < -1, a value of -oo is returned. 


y'*************************************************y' 

/* asin returns value expressed in radians */ 

/*************************************************/ 
extern double asin(); 
double realval, radians; 

realval = 1.0; 

radians = asin(realval); /* asin returns n/2 */ 
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atan 


Syntax 

Description 

Example 


double atan(x) 
double x; 

The atan function calculates the inverse tangent of a real number. Both 
argument x and the return value are double-precision floating-point val¬ 
ues. 

Given an input argument x, atan(x) returns a number y such that tan(y) = 
X. The return value is an angle expressed in radians, and is restricted to the 
range [-n/2,+n/2]. 

/****************************************************y 
/* atan returns a value expressed in radians */ 

/*****★**********************************************/ 
extern double atan(); 
double realval, radians; 

realval = 0.0; 

radians = atan(realval); /* return value = 0 */ 
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atanZ 


Arc Tangent 2 Function 


Syntax double atan2(u,v) 

double u,v; 

Description The atan2 function calculates the inverse tangent of the quotient of real 
number u divided by real number v. The two arguments u and v and the 
return value are all double-precision floating-point values. 

The return value is an angle expressed in radians, and is in the range 

[-n,+iT]. 

• Given input arguments u and v, atan(u,v) returns a number y such 
that tan(y) - u/v. 

• When both arguments are 0, the return value is +oo, and fp—error is 
called with error code = 23 (see the description of the floating-point 
facility in TMS34010 C Compiler User's Guide). 


Example extern double atan2 () ; 

double rvalu, rvalv; 
double radians; 

rvalu =0.0; 
rvalv = 1.0; 

radians = atan2(rvalr, rvalu); /* return value = 0 */ 


5-6 




Bit Expand Function 


bit—expand 


Syntax 


Description 


void bit—expand(srcbits, 
short srcbits[]; 
long srcpitch; 
int w, h; 
int xleft, ytop; 


srcpitch, w, h, xleft, ytop) 
/* source bit map */ 
/* source pitch */ 
/* dest width and height */ 
/* dest left side and top */ 


The bit—expand function expands a bit map onto the screen by replacing 
each bit in the source with one of two pixel values. Os in the bit map are 
expanded to pixel value COLORO, and 1 s are expanded to COLOR1. (See 
references to set—colorO and set—colorl functions.) 

• The source bitmap is specified in terms of its base address and pitch: 

- srcbits specifies the base address. 

- srcpitch specifies the memory pitch of the bit map. 

• The last four arguments specify the rectangular area of the screen 
that is modified: 

- The width w, 

“ The height h, and 

- The coordinates of the top left corner (xleft,ytop). 
w and h must be nonnegative. 

The source pitch is the difference in starting addresses of two adjacent 
rows in the source bitmap. (TMS34010 addresses are bit addresses. The 
pitch is the number of bits in memory between the start of one row of the 
bit map and the next.) The pitch can be any number greater than or equal 
to the number of pixels per row of the destination array (the w argument). 
The source array srcbits containing the bit map must be large enough 
to contain one bit for every pixel in the destination array. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 
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bit—expand 


Bit Expand Function 


Example 


^*********** ****************** 
/* Expand bitmap onto screen 


/ 

/ 


typedef enum { FIELDWIDTH = 1 } BIT; 
static BIT bitmap[] = { 

0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 1 , 0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 1 , 0 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
1 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
1 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 
1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0,0 


}; 

short buf[640/4]; /* Assume 4 bits/pixel 

int x=20, y=10, p=16, w=16, h=41; 


V 


init—video(1); 
init—grafix(); 
init^screen(); 
bit^expandCbitmap, 
zoom-rect(w, h, x. 


p, w, h, X, y) ; 
y, 10*w, 10*h, 100, 


10, buf); 
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Boundary Fill Function 


bound—fill 


Syntax 


Description 


void bound—fill(x, y, buffer, size, b—color) 

int X, y; /* starting point for */ 


/* seed fill */ 
char buffer[]; /* temporary buffer */ 
int size; /* size of buffer in */ 

/* bytes */ 
unsigned long b—color; /* boundary color */ 


The bound—fill function fills a bounded set of pixels. Starting at pixel 
coordinates (x,y), the function flood fills in ail directions until the boun¬ 
dary color b-color is encountered. Pixels in the filled region are set to 
the current C0L0R1. 

Given a pixel size of n bits, the function uses only the n LSBs of 
b_color. The function ignores higher order bits. 

A pixel is considered part of the bounded region if it is not equal to the 
boundary color, and has a horizontally or vertically adjacent neighbor pixel 
that is part of the region. (A diagonally adjacent neighbor is not suffi¬ 
cient.) 

Argument buffer is an array that the function uses as as temporary 
working storage. The function destroys the original contents of the buffer. 
Argument size is the size of the buffer In bytes. 

The bound—fill function differs from the seed—fill function, which fills a 
connected set of pixels the same color as the starting pixel. 

The bound—fill function aborts (returns immediately) if any of these con¬ 
ditions are detected: 

• The pixel at starting coordinates (x,y) is equal to the boundary color 
b—color. 

• Starting coordinates (x,y) lie outside the current visibility rectangle 
(window). 

• If at any point the buffer size Is insufficient to continue. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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bound—fill 


Boundary Fill Function 


Example 


long u, v,a, b, c, dc; 
char buffer[100]; 


init—video(1); 
init—grafix(); 
init—screen(); 

dc = 0x11111111; /* Assume 4 bits/pixel */ 

u = V = 36 << 16; 
for (c = -1; c 1= 0; c -= dc) { 
set—color1(c); 
a = u >> 16; 
b = V >> 16; 

draw—line(320+a, 240-b, 320+b, 240+a); 
draw—line(320+b, 240+a, 320-a, 240+b); 
draw—line(320-a, 240+b, 320-b, 240-a); 
draw—line(320-b, 240-a, 320+a, 240-b); 
u += u >> 3; 

V += V >> 3; 
u += V >> 3; 

V -= u >> 3; 

} 

set—color1(0x11111111); /* fill color */ 

bound—fill(320, 240, buffer, 100, 7); 
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Boundary Pattern Fill Function 


bound—patnfill 


Syntax 


Description 


void bound—patnfill(x, y, buffer, size, b_color) 
int X, y; /* starting point for */ 


/* seed fill */ 
char buffer[]; /* temporary buffer */ 
int size; /* size of buffer in */ 

/* bytes */ 
unsigned long b_color; /* boundary color */ 


The bound—patnfill function fills a bounded set of pixels. Starting at pixel 
coordinates (x,y), the function flood fills In all directions until the boun¬ 
dary color b-color Is encountered. Pixels in the filled region are drawn 
with the current pattern, which is drawn in COLORO and COLOR1. 

Given a pixel size of n bits, the function uses only the n LSBs of 
b_color. The function ignores higher order bits. 

A pixel is considered part of the bounded region if It is not equal to the 
boundary color, and has a horizontally or vertically adjacent neighbor pixel 
that Is part of the region. (A diagonally adjacent neighbor is not suffi¬ 
cient.) 

Argument buffer Is an array that the function uses as temporary working 
storage. The function destroys the original contents of the buffer. Argu¬ 
ment size Is the size of the buffer In bytes. 

The bound—patnfill function differs from the seed—patnfill function, which 
fills a connected set of pixels the same color as the starting pixel. 

The bound—patnfill function aborts (returns immediately) If any of these 
conditions are detected: 

• The pixel at starting coordinates (x, y) is equal to the boundary color 

b—color. 

• Starting coordinates (x,y) lie outside the current visibility rectangle 
(window). 

• jf at any point the buffer size is insufficient to continue. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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bound—patnfill 


Boundary Pattern Fill Function 


Example long u, v, a, b, c, dc; 

char buffer[100]; 

init—video(1); 
init—grafix(); 
init—screen(); 

dc = 0x11111111; /* Assume 4 bits/pixel */ 

u = V = 36 << 16; 
for (c = -1; c 1= 0; c -= dc) { 
set—color1(c); 
a = u >> 16; 
b = V >> 16; 

draw—line(320+a, 240-b, 320+b, 240+a) ; 
draw—line(320+b, 240+a, 320-a, 240+b) ; 
draw—line(320-a, 240+b, 320-b, 240-a); 
draw—line(320-b, 240-a, 320+a, 240-b) ; 
u += u >> 3; 

V += V >> 3; 
u += V >> 3; 

V -= u >> 3; 

} 

select—patn(10); /* fill pattern */ 

set—colorO(0x11111111); /* fill colorO */ 

set-colorl(0x33333333); /* fill colorl */ 

bound—patnfill(320, 240, buffer, 100, 7); 
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Ceiling Function Function 


ceil 


Syntax 

Description 

Example 


double ceil(x) 
double x; 

The ceil function returns a double floating point number representing the 
smallest integer greater than or equal to the input argument x. 

extern double ceil(); 

double answer; 

answer = ceil(3.1415,&exp); 

/* after execution, answer will be 4.0 */ 
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char—high 

Syntax 

Description 


Example 


Character Height Function 


int char-high () 

The char—high function returns the character height (in pixels) for the 
current font. The character height is defined as the vertical distance be¬ 
tween two adjacent rows of text, as measured from the two baselines. The 
character height is calculated as the sum of three quantities: 

• Ascent 

• Descent and 

• Leading. 


Note: 

Before you call the char—high function, call the init—text function to 
initialize the text data structures. 


extern int char_high(); 
static char *s[] = { 

”lst line”, 

"2nd line", 

"3rd line" 

}; 

int i, X, y; 

init—video(1); 
init—grafix() ; 
init—text(); 

X = 8; 

y = char—.high () ; 
for (i = 0; i <= 2; ++i) { 
draw—string(x, y, s[i]); 
y += char—highO; 

} 
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Get Maximum Character Width Function char—wide—max 


Syntax 

Description 


Example 


int char—wide—max() 

The char—wide—max function returns the width (in pixels) of the widest 
character in the current font. The returned value is the sum of the char¬ 
acter image width and the space preceding the next character to the right. 
(The character image is the bit map containing the character pattern.) 


Note: 

Before you call the char—wide—max function, call the init—text function 
to initialize the text data structures. 


extern int char—high(), char—wide—max(); 
static char c, *s; 
int i, w, h, X, y; 

init—video(1); 
init—grafix(); 
init—text(); 

X = w = char—wide-jnax () ; 

y = h = char—high(); 
s = "TMS34010”; 
while ((c = *s++) != ’\0') { 

draw—char{x, y, c) ; 
y += h; 

X += w; 

} 
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clear—screen 


Clear Screen Function 


Syntax 


Description 


Example 


void clear—screen(pixval) 

long pixval; /* pixel value to which */ 

/* screen is set */ 

The clear—screen function clears the screen to the specified pixel value. 
The entire display memory Is affected. For example, clear—screen(0) 
clears the entire frame buffer to Os, Including the color palette areas along 
the left edge of the screen. Video RAM register-to-memory cycles are 
used to make this function execute rapidly. 

The pixel value must be replicated to fill the entire 32 bits of pixval. For 
example, if the pixel size is 4 bits, and the pixel value is 5, pixval Is 
specified as 0x55555555. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


static short mypalet[163 = { 

0x0000, OxOOFO, OxOFOO, OxOFFO, OxFOOO, OxFOFO, 

OxFFOO, OxFFFO, 0x0000, 0x0090, 0x0900, 0x0990, 

0x9000, 0x9090, 0x9900, 0x9990 

}; 

init—video(1) ; 
init—grafix() ; 

/* Assume 4 bits per pixel */ 
clear—screen(0x55555555); 

/* Restore palette */ 

setall—palet(mypalet,OxFFFF,480,0); 

/* Draw border */ 

frame—rect(640, 480, 0, 0, 25, 20); 
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Close Viewport Function 


close—vu port 


Syntax 

Description 


Example 


int close—vuport(index) 

int index; /* Identifies viewport to be closed */ 

The close—vuport function closes a viewport that was previously opened 
and deletes all reference to the viewport structure from the graphics envi¬ 
ronment. The viewport is specified by argument index, which is the index 
value returned when the viewport was opened. 

If the active viewport Is designated by the argument, viewport 0 automat¬ 
ically becomes the active viewport when the previous viewport is closed. 
Viewport 0 cannot be closed; only viewports In the range 1 to n-^ can be 
closed, where n is the value returned by the get—vuport—max function. 
When the function is called with a valid index, the value 0 is returned to 
confirm that the viewport was closed as requested. When the function Is 
called with an Invalid index, a value of -1 Is returned to indicate that no 
action was taken. 


Note: 

Before you call the close—vuport function, call the init—vuport function 
to Initialize the viewport data structures. 


int index; 


index = open—vuport(); 


close—vuport(index); 
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color—biend 


Color Blend Function 


Syntax 


Description 


Example 


void color-JDlend(pxlval, yl, y2, redl, grnl, 
red2, grn2, blu2) 

/* pixel value affected 
starting scan line 
ending scan line 
red intensity at yl 
green intensity at yl 
blue intensity at yl 
red intensity at y2 
green intensity at y2 
blue intensity at y2 


int pxlval; 
int yl; 
int y2; 
int redl; 
int grnl; 
int blul; 
int red2; 
int grn2; 
int blu2; 


/* 

/" 

/* 

/" 

/" 

/* 

/* 


V 

V 

*/ 

V 

V 

V 

V 

V 

V 


blul, 


The color—blend function creates gradual changes in shading, highlights, 
and color blending effects by gradually varying the red, green, and blue 
intensities of the color associated with a specified pixel value on a line- 
by-line basis. Gradual vertical shading over takes place over a group of 
contiguous scan lines. The starting scan line Is designated by yl, and the 
ending scan line is designated by y2. 

Argument pxlval Is the pixel value whose color is affected over the spe¬ 
cified scan lines. It Is also the number of the color palette register loaded 
with the specified red, green, and blue Intensities. The range of pxlval 
Is 0 to 15. 

The y coordinates yl and y2 are relative to the origin of the active view¬ 
port. Note that it is not necessary for yl to be less than y2, and vice versa. 
Changes to the palette are automatically restricted to the y limits of the 
visibility rectangle (Intersection of screen with active viewport and clip¬ 
ping rectangle); scan lines corresponding to y values outside this range 
are unaffected. Intensities redl, grnl, blul, red2, grn2, and blu2 are 
8-blt values In the range 0 to 255. Linear interpolation is used to adjust 
the 4-blt red, green, and blue values output by the TMS34070 DACs to 
approximate the 8-blt resolutions specified for the Intensities. 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


/************************************************/ 
/* Draw solid—filled rectangle that gradually */ 
/* changes colors from red at the top to blue- */ 
/* gray at the bottom. */ 

/*******★****************************************/ 
set—colorl(0x33333333); /* 4 bits per pixel */ 

fill_rect(200, 100, 125, 65); 

color-blend(3, 65, 165, 255, 0, 0, 70, 70, 150); 
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Copy Matrix Function 


copy—matrix 


Syntax 


Description 


Example 


typedef long FIX 

void copy-matrix(matrixin, matrixout) 

FIX matrixin[16] ; 

FIX matrixout[16]; 

The copy—matrix function copies a 4x4 input matrix to a 4x4 output 
matrix. Both the input matrix matrixin and output matrix matrixout 
are stored in 16-element arrays of type FIX. 


typedef long FIX; 

{ 

FIX matrixin[16]; 
FIX matrixout[16]; 


copy—matrix(matrixin, matrixout); 

} 
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copy—vertex 


Copy Vertex Function 


Syntax 


Description 


Example 


void copy—vertex(n, 
typedef long FIX; 
int n; 

FIX vertexin[]; 
FIX vertexout[] ; 


vertexin, vertexout) 

/* fixed-point format 
/* number of vertices in list 
/* input vertex list 
/* output vertex list 


V 

V 

V 

V 


The copy—vertex function copies an input vertex list to an output vertex 
list. Input argument n is the number of vertices that are copied from the 
input vertex list to the output vertex list. Both the input vertex list ver¬ 
texin and output vertex list vertexout are arrays of 32-bit fixed-point 
values. A vertex is stored as three consecutive 32-bit coordinate values, 
X, Y, and Z. Each array contains 3n 32-bit elements. See Figure 4-10 
(page 4-30) for the vertex list format. 


typedef long FIX; 

/***************************************************/ 
/* Copy 5 vertices from vertexin[] to vertexout[]. */ 
/* Each vertex consumes 3 storage elements in an */ 
/* array, and the minimum array size is 3*5 =15. */ 

/********************★******************************/ 
FIX vertexin[3*5], vertexout[3*5]; 


copy—.vertex(5, vertexin, vertexout); 
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Copy Viewport Function 


copy—vuport 


Syntax 

Description 


Example 


int copy_vuport(index1, index2) 
int indexl, index2; 

The copy—vuport function copies ail attributes of the source viewport to 
the destination viewport. The source viewport is designated by argument 
indexl, which is the value returned by the open—vuport function when 
the viewport was opened. The destination viewport is designated by ar¬ 
gument index2. Both the source and the destination viewports must be 
opened before calling the copy—vuport function. 

The destination viewport automatically becomes the active viewport. If 
either viewport was not previously opened, a value of -1 is returned to 
indicate that an error was detected and that no viewport was copied. 
Otherwise, a value of 0 is returned to indicate that the viewport was suc¬ 
cessfully copied. See the description of the open—vuport function for a 
list of viewport attributes copied by the function. 


Note: 

Before you call the copy—vuport function, call the Init—vuport function 
to initialize the viewport data structures. 


/*****************************★********************/ 
/* Create 2 new viewports identical to the first, */ 
/* but located in different areas of the screen. */ 

/**************************************************/ 
int index[4]; /* viewport indices */ 

init—video(1); 
init—grafix(); 
init—vuport(); 
init—screen(); 

/*** Open viewport 1 ***/ 

index[1] = open—vuport(); 
size—vuport(150,300); 
move—vuport(10,50); 


/*** Make two new viewports similar to first ***/ 
index[1] = open—vuport(); /* create viewport 2 */ 

index[2] = open—vuport(); /* create viewport 3 */ 

copy—vuport(index[1],index[2]); 
copy—vuport(index[1],index[3]); 

/*** Move viewport 3 to right of viewport 1 ***/ 

move—vuport(340,50) ; 

/*** Move viewport 2 between other two viewports ***/ 
select—vuport(index[2]); 
move—vuport(170,50); 
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cos 


Cosine Function 


Syntax 

Description 

Example 


double cos(x) 
double X; 

The cos function calculates the cosine of real number x, where x is an that 
is angle expressed in radians. Both the argument and return value are 
double-precision floating-point values. 

An argument x with a magnitude greater than or equal to 1 .OE+8 causes 
cos(x) to return a value of 0, and fp—error is called with error code = 17 
(see the TMS34010 C Compiler User's Guide for a description of the 
fp—error function). 

extern double cos() ; 

double radians, aval; /* cval is returned by cos */ 
radians = 3.1415927; 

cval = cos(radians); /* return value = -1 */ 

return(cval); 
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Hyperbolic Cosine Function 


cosh 


Syntax 

Description 

Example 


double cosh(x) 
double x; 

The cosh function returns the hyperbolic cosine of a real number x. Both 
the argument x and return value are double-precision floating-point val¬ 
ues. 

extern double cosh(); 
double X, y; 

X = 0.0 ; 

y = cosh(x); /* return value = 1.0 */ 




cotan 


Cotangent Function 


Syntax 

Description 


Example 


double cotan(x) 
double x; 

The cotan function calculates the cotangent of a real number x, where x 
is an angle that is expressed in radians. The sign of the result is the same 
as the sign of the argument. Argument x and the return value are both 
double-precision floating-point values. 

If the absolute value of argument x is greater than or equal to 1.0E+8, 
then a value of 0 Is returned, and fp—error is called with error code = 20. 
If the absolute value of x is less than or equal to 1 .OE-300, then cotan(x) 
returns a value of +oo or -oo, and fp—error is called with error code = 19 
(see the TMS34010 C Compiler User's Guide for a description of the 
fp—error function). 

extern double cotan(); 
double radians, cotval; 

radians = 3.1415927/2.0; /* 90 degrees */ 

cotval = cotan(radians); /* return value =0 */ 
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Compare Point to Window Function 


cpw 


Syntax 

Description 


int cpw(X, Y) 

int X, y; /* pixel coordinates */ 

The cpw function generates 4-bit outcode based on a pixel's position re¬ 
lative to the current window. Arguments x and y are the coordinates of 
the pixel. 

The window is the visibility rectangle defined as the Intersection of: 

• The screen, 

• The viewport and 

• The clipping rectangle. 

The outcode value is contained in the 4 LSBs of the return value. Outcode 
values include: 

OOOO 2 If the point lies within the window. 

01XX 2 if the point lies above the window. 

1 0 xx 2 if the point lies below the window. 
xxOI 2 if the point lies left of the window, 
xxl O 2 If the point lies right of the window. 

Refer to the TMS34010 User's Guide for a detailed description of the 
outcodes. 

Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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cpw 


Compare Point to Window Function 


Example 


/**********************************************/ 

/* Bounce dot off walls of window */ 

/**********************************************/ 

#define XMIN 100 /* Define window limits */ 

#define YMIN 100 

#define XMAX 300 

#define YMAX 300 

extern int cpw(); 

int i, outcode, x=XMIN, y=YMIN, dx=5, dy=3; 

init—video(1); 
init—grafix(); 
init—vuport() ; 
init_screen(); 

set_cliprect(XMAX-XMIN, YMAX-YMIN, XMIN, YMIN); 
for (i = 1; i < 200; ++i) { 

if ((outcode = cpw(x += dx, y += dy)) != 0) { 

if (outcode & 1) { /* Bounce off */ 

X += 2*(XMIN-x); /* left wall */ 

dx = “dx; 

} else if (outcode & 2) { /* Bounce off */ 

X “= 2*(x“XMAX); /* right wall */ 

dx = “dx; 

} 

if (outcode & 4) { /* Bounce off */ 

y += 2*(YMIN~y); /* top wall */ 

dy = -dy; 

} else if (outcode & 8) { /* Bounce off */ 

y “= 2*(y“YMAX); /* bottom wall */ 

dy = “dy; 

} 

draw—point(x, y); 
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Delay Function 


delay 


Syntax 

Description 


Example 


void delay(n) 

int n; /* number of ticks */ 

The delay function waits for a number of ticks, n, to elapse before return¬ 
ing control to the calling program. One tick equals 1/60th of a second. 
The function is synchronized to the frame rate, and a tick is registered at 
the end of each frame. 

Given a positive argument n, the function counts n+1 end-of-frames be¬ 
fore returning control to the calling program. Control is returned just after 
the bottom line of the display is output. If n = 0, the function delays only 
until the end of the current frame is encountered. 

If the display Interrupt Is enabled, the function aborts immediately upon 
being called. If argument n is negative, the function aborts immediately. 
No error code is generated in either case. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


/**********************************y 
/* Draw ticking second hand */ 

^**********************************y' 

typedef long FIX; 

static FIX rotation[3] = {0, 0, 0}; 

static long xyz[] = (0,-200,0, 30,0,0, 0,30,0, -30,0,0}; 
static short connect[8] = (0,1, 1,2, 2,3, 3,0}; 

FIX matrix[163; 

FIX verts[12]; 

short xy[8]; 
int angle; 


init—video(1) ; 
init_grafix(); 
init—vuport() ; 
set—origin(320, 240); 
for (;;) 

for (angle = 0; angle < 360; angle 
init_matrix(matrix); 
rotation[0] = angle << 16; 
rotate(matrix, rotation); 
long—to—fix(12, xyz, verts); 
transform(matrix, 4, verts); 
vertex—to—point(4, verts, xy); 
delay(60); /* 

init—screen(); 

draw-oval(420, 420, -210, -210) 
draw—polyline(4, connect, xy); 

} 


+= 6) { 


Wait 1 second */ 
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draw—char 


Draw Character Function 


Syntax 


Description 


Example 


int dr aw—char (x, y, c) 

int X, y; /* starting coordinates */ 

char c; /* ASCII character code */ 

The draw—char function draw a single bit-mapped character. The char¬ 
acter is drawn in the current font. 

• Arguments x and y specify the position of the character: 

Coordinate x is the horizontal position at the left edge of the 
character. 

- Coordinate y is the vertical position at the baseline of the string 
(not at the top of the string). 

• Argument c is a pointer to a character. 

The return value is the x coordinate of the next character position to the 
right of the specified character. The x value is expressed in viewport- 
relative coordinates. If the character lies entirely above or below the win¬ 
dow, the unmodified starting x coordinate is returned. 


Note: 

Before you call the draw—char function, call the init—text function to 
initialize the text data structures and call the init-grafix function to ini¬ 
tialize the graphics environment. 


int X , y; 
char c; 

init—video(1); 
init—grafix(); 

init—text(); /* Install default font */ 

init—screen(); 

X = 0; 

y = -170 << 16; 

/** Draw the letters 'A* through 'Z’ **/ 
for (c = 'A'; c < 'Z'; ++c) { 

draw—char((x>>16)+304, (y>>16)+244, c); 

X += y >> 3; 
y -= X >> 3; 

draw—char((x>>16)+304, (y>>16)+244, c -'A'+'a'); 

X += y >> 3; 
y -= X >> 3; 

} 
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Draw Line Function 


draw—line 


Syntax 


Description 


Example 


void draw-line(xl, yl, x2, y2) 

int xl, yl; /* Start coordinates */ 

int x2, y2; /* End coordinates */ 

The draw—line function uses Bresenham's algorithm to draw a line from 
the starting point to the ending point. 

• xl and yl specify the starting coordinates 

• x2 and y2 specify the ending coordinates. 

The line is one pixel in thickness and is drawn in the current C0L0R1. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int i, xl = -40, yl = 80, x2 = 80, y2 = 280; 

init—video{1); 
init—grafix(); 
init—screen(); 

/*** Draw 202 lines in different orientations ***/ 
for (i = 202; i > 0; —i) { 

draw_line(xl+305, yl+222, x2+305, y2+222); 


xl 

-i-= 

yl 

>> 

5; 

yl 


xl 

>> 

5; 

x2 

+= 

y2 

>> 

5; 

y2 


x2 

>> 

5; 
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draw—oval 


Syntax 


Description 


Example 


Draw Oval Function 


void draw~oval(w, h, xleft, ytop) 

int w, h; /* width and height of */ 

/* enclosing rectangle */ 
int xleft, ytop; /* XY coordinates at */ 

/* top left corner */ 

The draw—oval function draws the outline of an ellipse given the minimum 
enclosing rectangle in which the ellipse is inscribed. The ellipse is in 
standard position, with its major and minor axes parallel to the coordinate 
axes. The enclosing rectangle is defined by four arguments: 

• The width w 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The outline is one pixel thick, and is drawn In the current C0L0R1. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


int w, h, X, y; 

init—video(1); 
init—grafix() ; 
init—screen(); 

/*** Draw ellipses of various sizes ***/ 
for (w = 0, X = 4; w < 33; ++w, x += w + 3) 

for (h = 0, y = 4; h < 28; ++h, y += h + 3) 

draw—oval(w, h, x, y); 
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Draw Oval Arc Function 


draw—ovalarc 


Syntax 


Description 


Example 


void draw—ovalarc(w, h, xleft, ytop, theta, arc) 

int w, h, /* width and height */ 

int xleft, ytop; /* top left corner */ 

int theta; /* starting angle (degrees) */ 

int arc; /* angle extent (degrees) */ 

The draw—ovalarc function draws an arc taken from an ellipse. The ellipse 
is in standard position, with the major and minor axes parallel to the co¬ 
ordinate axes. The arc is one pixel in thickness, and is drawn in the current 
C0L0R1. 

The ellipse from which the arc is taken is specified in terms of the mini¬ 
mum enclosing rectangle in which it is inscribed. The first four arguments 
define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta, is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Po¬ 
sitive angles are in the clockwise direction, negative angles are 
counterclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or 
negative) spanned by the angle. If the arc extent Is outside the range 
[-359, + 359], the entire ellipse is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 de¬ 
grees representing one full rotation. 


Note; 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


#define XC 
#define YC 
#define WMAX 
#define HMAX 
#define DX 
#define DY 
int w, h; 


320 /* Screen center coordinates */ 

240 

636 /* Limits of enclosing rectangle */ 
476 

16 /* Increment rectangle dimensions */ 
12 


/*** Draw spiral using draw—ovalarc function ***/ 
init—video(1); 
init—grafix(); 
init—screen(); 

for (w = WMAX, h = HMAX; w > DX; h ~= DY) { 

draw—ovalarc(w, h, XC-w/2, YC-h/2, 0, 270); 
w -= DX; 

draw—ovalarc(w, h, XC~w/2, YC-h/2, 270, 90); 
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draw—piearc 


Draw Pie Arc Function 


Syntax 


Description 


Example 


void draw—piearc(w, h, 
int w, h, 
int xleft, ytop; 
int theta; 
int xend, yend 


xleft, ytop, theta, arc) 

/* width and height */ 
/* top left corner */ 
/* starting angle (degrees) */ 
/* XY coordinates for end pt*/ 


The draw—piearc function draws an arc taken from an ellipse. Two 
straight lines connect the two end points of the arc with the center of the 
ellipse. The ellipse is in standard position, with the major and minor axes 
parallel to the coordinate axes. The arc and two lines are all one pixel In 
thickness, and are drawn in the current COLOR1. 

The ellipse from which the arc is taken Is specified in terms of the mini¬ 
mum enclosing rectangle In which it is Inscribed. The first four arguments 
define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta, is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Po¬ 
sitive angles are in the clockwise direction, negative angles are 
counterclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or 
negative) spanned by the angle. If the arc extent Is outside the range 
[-359,+359], the entire ellipse Is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 de¬ 
grees representing one full rotation. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, t, dt, dx; 

init—video (1) ; 
init—grafix() ; 
t = dx = dt = 8; 
w = h = 80; 

/** Draw animated pieman **/ 

for (x = ~w, y = 240-W/2; x < 650; x += dx) { 
if ( (t += dt) >80 II t <= 0) 
dt = -dt; 
delay(0); 
init—screen(); 

draw—piearc(w, h, x, y, t/2, 360-t); 
draw—piearc(w, h, x+w/2, y, -15, 30); 
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Draw Point Function 


draw—point 


Syntax 

Description 

Example 


void draw-point(x, y) 

int X, y; /* pixel coordinates */ 

The draw—point function draws a single pixel. Arguments x and y give 
the XY coordinates of the designated pixel. The pixel is drawn in the 
current C0L0R1. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int i, X, y, xy, yx; 

init—video(1); 
init—grafix(); 
init—screen(); 

X = xy = 0; 
y = yx = 200; 

/** Draw lissajous pattern in dots **/ 
for (i = 1200; i > 0; —i) { 

draw—point(x+320, y+240); 

X += yx >> 4; 
yx -= X >> 4; 
y += xy >> 5; 
xy -= y >> 5; 

} 
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draw—polyline 


Draw Polyline Function 


Syntax 


Description 


void draw—polyline(n, linelist, ptlist) 

int n; /* number of lines */ 
short linelist[]; /* list of lines */ 
short ptlist[]; /* list of points */ 


The draw—polyline function draws multiple lines. 


• n specifies the number of lines that are drawn. 

• linelist is an array of type short; it specifies the list of lines that 
are drawn. Each element in the linelist array is an index into the 
ptlist array. 


• The third argument, the ptlist array, contains the XY coordinates 
of the starting and ending points for each line. 

Each pair of adjacent 16-bit elements in the ptlist array is an X coordi¬ 
nate followed by a Y coordinate. Each pair of adjacent 16-bit elements in 
the linelist array is a pair of indices into the ptlist array, and desig¬ 
nates the start and end points of a line. 


For example, the first line drawn is specified in the first two elements, 
linelist[0] and linelist[1]. Assume that these contain index values 
4 and 7, respectively. The starting coordinates for the line are contained 
in ptlist[2*4] and ptlist[2*4+1]. The ending coordinates are con¬ 
tained in ptlist[2*7] and ptlist[2*7 + 1 ]. 


The individual elements of the linelist array are assigned as follows: 


linelist[0] 
linelist [1 ] 
linelist[2] 
linelist[3] 


= starting point of line 0 
= ending point of line 0 
= starting point of line 1 
= ending point of line 1 


linelist [2n] = starting point of line n-1 

linelist[2n+1 ] = ending point of line n-1 


The individual elements of the ptlist array are assigned as follows: 


ptlist[0] 
ptlist [1 ] 
ptlist[2] 
ptlist[3] 


= X coordinate value for point 0 
= y coordinate value for point 0 
= X coordinate value for point 1 
= y coordinate value for point 1 


ptlist[2m] = X coordinate value for point m-1 
ptlist[2m + 1 ] = y coordinate value for point m-1 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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Draw Polyline Function 


draw—polyline 


Example 

static short xy[] = { 

380,200, 480,200, 480,300, 380,300, 

340,270, 340,170, 440,170, 

230,180, 280,300, 160,300, 146,263 

} ; 

static short cube[] = { 

0,1, 1,2, 2,3, 3,4, 4,5, 5,6, 6,1, 3,0, 5,0, 

} ; 

static short pyramid[] = { 

7,8, 8,9, 9,10, 10,7, 7,9 

} ; 

/*** Draw a cube and a pyramid sitting side by side ***/ 
init—video(1) ; 
init—grafix(); 
init—screen(); 

draw—polyline(9, cube, xy); 

set—color1(0x11111111); /* Assume 4 bits/pixel */ 

draw—polyline(5, pyramid, xy); 
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draw—rect 


Draw Rectangle Function 


Syntax 


Description 


Example 


void draw—rect(w, h, xleft, ytop) 

int w, h; /* width and height */ 

/* of rectangle */ 

int xleft, ytop; /* coordinates at top */ 

/* left corner */ 

The draw—rect function draws the outline of a rectangle. The first four 
arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The outline is one pixel in thickness, and is drawn in the current C0L0R1. 

The draw—rect function is equivalent to the following four calls to the 
draw—line function: 

draw—line(xleft, ytop, xleft+w, ytop); 
draw—line(xleft, ytop+h, xleft+w, ytop+h); 
draw—line(xleft, ytop+1, xleft, ytop+h-2); 
draw—line(xleft+w, ytop+1, xleft+w, ytop+h-2); 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment 


init—video (1) ; 


init. 

init. 

^-k-k-k-k 

/** 
/**** 
draw—; 
draw, 
draw, 
draw- 
draw. 


grafix(); 
screen(); 

************************** 
Draw one big rectangle ** 
and four little ones ** 
************************** 

.rect(440, 280, 100, 100); 
Tect(420, 30, 110, 110); 
,rect(220, 220, 110, 150); 
.reot(190, 150, 340, 150); 


.rect(190, 60, 340, 310); 


/ 

/ 

/ 

/ 
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Draw Character String Function 


draw-string 


Syntax 


Description 


Example 


int draw—string(x, y, s) 

int X, y; /* starting coordinates */ 

char *s; /* ASCII string terminated by NULL */ 

The draw-string function draws a string of characters to a position on the 
screen. The string is drawn in the current font. 

• The first two arguments define the starting position for the string: 

- Coordinate x is the horizontal position at the left edge of the 
string. 

“ Coordinate y is the vertical position at the baseline of the string 
{not the top of the string). 

• Argument s is a character string. The string Is in standard C format: 
a sequence of 8-bit ASCII character codes terminated by a NULL 
character (ASCII code = 0). 

The return value is the x coordinate of the next character position to the 
right of the string. The x value is expressed in viewport-relative coordi¬ 
nates. If the string lies entirely above or below the window, the unmodi¬ 
fied starting x coordinate is returned. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 


int i, X, y; 
char *s; 

s = "Hello world."; 
init—video(1); 
init—grafix(); 
init—text(); 
init—screen(); 
transp—on(); 

X = 0 ; 

y = 200 << 16; 

/** Write "Hello world" to the screen 50 times **/ 
for (i = 50; i > 0;—i) { 

draw—stringC (x>>16)+272, (y>>16)+244, s); 

X += y >> 3; 
y -= X >> 3; 

} 
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exp 


Exponential Function 


Syntax doub1e exp(x) 

double x; 

Description The exp function calculates the exponential function of real number x. 

The value returned is natural number e raised to the power x. Both the 
argument and return value are double-precision floating-point values. 

• If X > 500, a value of +oo is returned, and fp—error is called with 
error code = 21 (see the reference to the fp—error function in the 
TMS34010 C Compiler User's Guide). 

• If X < -500, a value of 0 is returned, and fp—error is called with error 
code = 22. 


Example extern double exp(); 

double X, y; /* y is returned by exp */ 

X = 2.0; 

y = exp(x); /* Y = 7.38, which is e**2.0 */ 
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Absolute Value Function 


tabs 


Syntax 

Description 

Example 


double fabs(x) 
double x; 

The tabs function calculates the absolute value of a real number x. Both 
argument x and the return value are double-precision floating-point val¬ 
ues. 

extern double fabs(); 
double X, y; 

X = -57.5; 

y = fabs(x); /* return value = +57.5 */ 
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fill—convex 


Fill Convex Polygon Function 


Syntax 


Description 


int fill_convex(n, edgelist, ptlist) 

int n; /* number of polygon vertices */ 

short edgelist[]; /* list of edges */ 

short ptlist[]; /* list of vertices (points) */ 

The fill—convex function fills a convex polygon given a list of points re¬ 
presenting the vertices. In order to be drawn correctly, the polygon must 
be convex; that is, it should contain no concavities. A polygon must have 
at least three vertices to be visible. An edge of the polygon Is assumed 
between the first and last vertices specified. The polygon is solid-filled 
with the current COLOR1. 

The function requires three input arguments: 

• Argument n defines the number of vertices In the polygon. 

• The second argument, edgelist. Is an array of type short. The 
members of the array are indices that specify the order in which the 
vertices are traversed, moving in a clockwise direction around the 
edge of the polygon. {Clockwise, in this context, assumes X in¬ 
creasing from left to right and Y increasing from top to bottom.) 
Each element of the edgelist array is an index Into the ptlist 
array. 

• The third argument, ptlist, is an array of type short. Each pair of 
adjacent 16-bit elements contains the X and Y coordinates, respec¬ 
tively, of a vertex. 

For example, edgelist [k] contains the index for vertex k, where k is In 
the range 0 to n-1. The XY coordinates for vertex k are contained in 
ptlist[2*n] and ptlist[2*n+1]. 

The fill—convex function does automatic culling of back faces to support 
3D applications. In other words, a polygon Is drawn only If its front side 
is visible; that Is, if it is facing toward the screen. If the vertices are spec¬ 
ified in counterclockwise order, the polygon is assumed to be facing away 
from the screen and is therefore not drawn. In this case, a value of 0 Is 
returned by the function. Otherwise, a value of 1 is returned to indicate 
that the polygon is visible. 

The back face test is done by first comparing vertices n-2, n-1 and 0 to 
determine whether the polygon vertices are specified In clockwise (front 
face) or counterclockwise (back face) order. This test relies on the poly¬ 
gon containing no concavities. If the three vertices are found to be coli- 
near, the back face test is made again using the next three vertices, n-1, 0 
and 1. The test repeats until three vertices are found that are not colinear. 
If all the vertices are colinear, the polygon Is invisible and a value of 0 Is 
returned. 

This function is similar to the fill—polygon routine, but is specialized for 
rapid drawing of convex polygons. Note that the edgelist array format 
for the fill—convex function differs from the linelist array format for the 
fill—polygon function. While the fill-convex function is more specialized 
than the fill—polygon function, it also executes more rapidly and supports 
realtime applications such as animation. 
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Fill Convex Polygon Function 


fill—convex 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


Example long i, hue; 

static short connect[] = { 0, 1, 2 }; 

static short xy[] = { 0,-170, 196,170, -196,170 ); 

init—video(1); 
init—grafix(); 
init—vuport(); 
set—origin(320, 240); 
init—screen(); 

/** Fill triangles in 15 different colors **/ 
for (i = 15, hue =0; i > 0; --i) { 
set—color1(hue += 0x11111111); 
fill—convexC3, connect, xy); 
xy[0] += xy[l] » 3; 

xy[l] -= xy[0] » 3; 

xy[2] += xy[3] >> 3; 

xy[3] -= xy[2] >> 3; 

xy[4] += xy[5] » 3; 

xy[5] -= xy[4] >> 3; 

} 
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fill—oval 


Syntax 


Description 


Example 


Fill Oval Function 


void fill^ovaKw, h, xleft, ytop) 

int w, h; /* width and height of */ 

/* enclosing rect */ 

int xleft, ytop; /* XY coordinates of */ 

/* top left corner */ 

The fill—oval function draws an ellipse that is solid-filled with the current 
C0L0R1. The ellipse is in standard position, with its major and minor 
axes parallel to the coordinate axes. 

The ellipse is defined by the minimum enclosing rectangle in which it is 
inscribed. The first four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y; 

init—video(1); 
init—grafix(); 
init—screen(); 

/*** Fill ellipses of various sizes ***/ 
for (w = 0, X = 4; w < 33; ++w, x += w + 3) 

for (h = 0, y = 4; h < 28; ++h, y += h + 3) 

fill—oval(w, h, X, y) ; 
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Fill Pie Arc Function 


fili—piearc 


Syntax 


Description 


void fill—piearc(w, h, xleft, ytop, theta, arc) 


int 

w, h, 

/* 

width and height 

V 

int 

xleft, ytop; 

/* 

top left corner 

V 

int 

theta; 

/* 

starting angle (degrees) 

V 

int 

arc; 

/* 

extent of angle (degrees) 

V 


The fill—piearc function draws a pie-shaped wedge that is solid-filled with 
the current C0L0R1. The wedge is bounded by an arc and two straight 
edges. The arc is taken from an ellipse in standard position, with its major 
and minor axes parallel to the coordinate axes. The two straight edges are 
defined by lines connecting the end points of the arc with the center of 
the ellipse. 

The ellipse from which the arc is taken is specified in terms of the mini¬ 
mum enclosing rectangle in which it is inscribed. The first four arguments 
define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta. Is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Po¬ 
sitive angles are in the clockwise direction, negative angles are 
counterclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or 
negative) spanned by the angle. If the arc extent is outside the range 
[-359,+359], the entire ellipse Is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 de¬ 
grees representing one full rotation. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 
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fill—piearc 


Fill Pie Arc Function 


Example 


/********************★***********/ 

/* Draw animated pieman */ 

y*****************************★**/ 
int w, h, X, y, t, dt; 

init—video(1); 
init—grafix(); 
t = dt = 8; 
w = h = 80; 

for (x = -120, y = 350; x < 720; x += 
if ( (t += dt) > 80 I I t <= 0) 
dt = -dt; 
delay(0) ; 
init—screen(); 

fill—piearc(w, h, x, y, t/2, 360 
fill—piearc(w, h, x+40, y, -15, 

} 


8) { 

-t) ; 
30) ; 
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Fill Polygon Function 


fill—polygon 


Syntax 


Description 


void fill-polygon(n, 
int n ; 

short linelist[]; 
short ptlist [ ] ; 


linelist, ptlist) 

/* number of edg«s */ 
/* list of edges */ 
/* list of vertex coordinates */ 


The fill—polygon function fills a polygon given a list of lines representing 
the edges of the polygon. No restrictions are placed on the shape of the 
polygons filled by the function: edges can cross each other, filled areas 
can contain holes, and two or more filled regions can be disconnected 
from each other. The polygon is solid-filled with COLOR1. 

The function requires three input arguments: 


• Argument n defines the number of vertices in the polygon. 

• The second argument, linelist, is an array of type short. Each pair 
of elements in the linelist array defines an edge: the first of the 
two elements defines the starting vertex of the edge, and the second 
defines the ending vertex. Each element of the linelist array is 
an index into the ptlist array. 

• The third argument, ptlist, is an array of type short. Each pair of 
adjacent 16-bit elements contains the X and Y coordinates, respec¬ 
tively, of a vertex. 


Each pair of adjacent 16-blt elements In the ptlist array is an X coordi¬ 
nate followed by a Y coordinate. Each pair of adjacent 16-bit elements in 
the linelist array is a pair of indices into the ptlist array. 

For example, the first edge that is drawn Is specified In array elements, 
linelist[0] and linelist[1]. Assume that these contain Index values 
4 and 7, respectively. The starting coordinates for the line defining the 
edge are contained in ptlist[2*4] and ptlist[2*4 + 1 ]. The ending 
coordinates are contained in ptlist[2*7] and ptlist[2*7 + 1 ]. 


The individual elements of the linelist array are assigned as follows: 


linelist [0] 
linelist [1 ] 
linelist[2] 
linelist[3] 


= Starting vertex for edge 0 
= ending vertex for edge 0 
= starting vertex for edge 1 
= ending vertex for edge 1 


linelist[2n] = starting vertex for edge n-1 

linelist[2n + 1 ] = ending vertex for edge n-1 


The individual elements for the ptlist array are assigned as follows: 


ptlist [0] 

ptlist[1] 

ptlist[2] 
ptlist [3] 


= X coordinate value for point 0 
= y coordinate value for point 0 
= X coordinate value for point 1 
= y coordinate value for point 1 


ptlist[2m] = X coordinate value for point m-1 
ptlist[2m + 1 ] = y coordinate value for point m-1 
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fill—polygon 


Fill Polygon Function 


Example 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment 


static short xy[] = { 

440,80, 540,380, 500,380, 472,300, 368,300, 
340,380, 300,380, 400,80, 420,140, 459,260, 

381,260, 277,133, 248,346, 300,340, 222,138, 

319,147, 204,333, 180,311, 340,172, 360,200, 

160,280, 150,240, 368,240, 360,280, 160,200, 

180,168, 340,308 

} ? 

static short shape[] = { 

0,1, 1,2, 2,3, 3,4, 4,5, 5,6, 6,7, 7,0, 8,9, 
9,10, 10,8, 11,12, 12,13, 13,14, 14,11, 15,16, 
16,17, 17,18, 18,15, 19,20, 20,21, 21,22, 22,19, 
23,24, 24,25, 25,26, 26,23 

} ; 

init—video (1) ; 
init—grafix() ; 
init—screen(); 

/* Fill overlapping 'A* and shapes */ 

fill—polygon(27, shape, xy); 
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Fill Rectangle Function 


fill—rect 


Syntax void fill_rect(w, h, xleft, ytop) 

int w, h; /* width and height */ 

/* of rectangle */ 

int xleft, ytop; /* XY coords at top */ 

/* left corner */ 

Description The fill—rect function draws a rectangle that Is solid-filled with the current 

C0L0R1. The first four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 


Example init_video (1) ; 

init_grafix() ; 
init—screen(); 

/******★*****************★*****/ 

/** Draw one big rectangle **/ 

/** and four little ones **/ 

y******************************y 

fill_rect(440, 280, 100, 100); 

set—color1(0x11111111); /* Assume 4 bits/pixel */ 

fill_rect(420, 30, 110, 110); 

fill_rect(220, 220, 110, 150); 

fill_rect(190, 150, 340, 150); 

fill_rect(190, 60, 340, 310); 
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fix—to—float 


Fixed Point to Float Function 


Syntax float *fix—to_float(n, in_array, out—array) 

typedef long FIX; /* fixed-point format */ 

int n; /* number of elements to be */ 

/* converted */ 

FIX in—array[]; /* array of fixed-point values */ 

float out—array[]; /* array of float values */ 


Description The fix—to—float function converts an array of fixed-point values to sin¬ 
gle-precision floating-point values. Elements of input array are 32-bit, 2s 
complement, fixed-point numbers with the binary point located between 
the 16 LSBs and 16 MSBs. Elements of output array are of type float. 

The input arguments include: 

• The number of elements n that are converted, 

• The input array in—array, and 

• The output array out—array. 

A pointer to the first element of the output array Is returned. 


Example typedef long FIX; 

long xyzl[9] = { 0,-58,0, 50,29,0, -50,29,0 }; 
FIX xyz2[9]; 
float xyz3[9]; 

long—to—fix(9, xyzl, xyz2); 
fix—to—float(9, xyz2, xyz3); 
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Fixed Point to Long Function 


fix—to—long 


Syntax 


Description 


Example 


long *fix_to_long(n, in_array, out—array) 
typedef long FIX; 

int n; /* number of elements to */ 

/* be converted */ 

FIX in—array[]; /* array of fixed-point 

/* values */ 

long out—array[]; /* array of integers */ 

The fix—to—long function converts an array of fixed-point numbers to long 
integers. Elements of the input array are 32-bit 2s complement fixed- 
point numbers with the 16 LSBs to the right of the binary point. Elements 
of the output array are 32-bit 2s complement integers (C type long). The 
conversion from fixed-point format is done by simply shifting the elements 
right by 16 (truncation with sign extension). 

The input arguments include: 

• The number of elements n that are converted, 

• The input array in-array, and 

• The output array out—array. 

A pointer to the first element of the output array Is returned. 

The value returned by the function is a pointer to the output array, 

out—array. 


typedef long FIX; 

static FIX xyl[2] = { 0,“150<<16 }; 
long xy2[2]; 

init—video(1); 
init—grafix() ; 
init—vuport() ; 
set—origin(320, 240); 
for (;;) { 

fix—to—long(2, xyl, xy2); 
delay(0) ; 
init—screen() ; 

draw—line(0, 0, xy2[0], xy2[l]); 
xyl[0] -= xyl[l] >> 6; 
xylil] += xylio] >> 6; 

} 


5-49 




fix—to—short 


Fixed Point to Short Function 


Syntax 


Description 


Example 


short *fix—to—short(n, in—array, out—array) 
typedef long FIX; 

int n; /* number of elements to be */ 


/* converted */ 

FIX in—array[]; /* array of fixed-point */ 

/* values */ 

short out—array[]; /* array of integers */ 


The fix—to—short function converts an array of fixed-point numbers to 
short integers. Elements of the input array are 32-bit 2s complement 
fixed-point numbers whose 16 LSBs are to the right of the binary point 
Elements of the output array are 16-bit 2s complement integers (C type 
short). The conversion from fixed-point format is done by simply shifting 
the elements right by 16 (truncation). 

The input arguments include: 

• The number of elements n that are converted, 

• The input array in_array, and 

• The output array out—array. 

The value returned by the function is a pointer to the output array, 

out—array. 


typedef long FIX; 

static short ptiist[] = { 0,-200, 30,15, -30,15 }; 
static short connect[] = C 0, 1, 2 }; 

FIX xy[6] ; 
int i; 

init—video(1) ; 
init—grafix(); 
init—vuport() ; 

short—to—fix(6, ptlist, xy); 
set—origin(320, 240); 
for ( ; ; ) { 

for (i = 0; i <= 2; ++i) { 

xy[2*i] -= xy[2*i+l] >> 6; 
xy[2*i+l] += xy[2*i] >> 6; 

} 

fix—to—short(6, xy, ptlist); 
delay(O) ; 
init—screen(); 

fill—convex(3, connect, ptlist); 

} 
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Fixed Point to Float Function 


FIX2FL 


Syntax 

Description 


Example 


.global FIX2FL 

The FIX2FL function converts a fixed-point number to a single-precision 
floating-point number. The format used for a 32-bit, 2s complement, 
fixed-point number places the binary point between the 16 LSBs and 16 
MSBs. Refer to discussion of single-precision floating-point format in 
Appendix D of the TMS34010 C Compiler User's Guide. 


Note: 

You cannot call the FIX2FL function from a C program. You must call 
it from an an assembly language program by using the EXGPC in¬ 
struction. Arguments are passed through the TMS34010 register file. 


The argument is passed to this function in register A10 and the result is 
returned in A10. The prior contents of A8, All, and A10 are lost. The 
function is called with an EXGPC instruction using register A5. 


******************************************************** 
*** Convert fixed-point array to floating point. *** 


LOOP: 


MOV I 

FIX2FL,A4 

7 

MOVE 

*A1+,A10,1 

7 

MOVE 

A4,A5 

7 

EXGPC 

A5 

7 

MOVE 

A10,*A2+,1 

; 

DSJS 

AO,LOOP 

7 


load address of FIX2FL routine 

get next element from input 
copy address of FIX2FL routine 
execute FIX2FL routine 
copy converted element to output 
more elements to convert? 
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FL2FIX 


Float to Fixed Point Function 


Syntax 

Description 


Example 


.global FL2FIX 

The FL2FIX function converts a single-precision floating-point value to a 
fixed-point value. The format used for a 32-bit 2s complement fixed- 
point number places the binary point between the 16 LSBs and 16 MSBs. 


Note: 

You cannot call the FL2FIX function from a C program. You must call 
it from an an assembly language program by using the EXGPC in¬ 
struction. Arguments are passed through the TMS34010 register file. 


The argument is passed to this function In register A10 and the result Is 
returned in A10. The prior contents of A8, A10, and A11 are lost. The 
function is called with an EXGPC Instruction using register A5. 


*** Convert floating-point array to fixed point. *** 


MOVI FL2FIX,A4 

LOOP: 

MOVE *A1+,A10,1 
MOVE A4,A5 
EXGPC A5 

MOVE A10,*A2+,1 
DSJS AO,LOOP 


; load address of FL2FIX routine 

; get next element from input 
; copy address of FL2FIX routine 
; execute FL2FIX routine 
; copy converted element to output 
; more elements to convert? 
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Floating-Point Add Function 


FL-ADD 


Syntax 

Description 


Example 


.global FL_ADD 

The FL—ADD function adds two single-precision floating-point values. 
Refer to discussion of single-precision floating-point format in Appendix 
D of the TMS34010 C Compiler User's Guide. 


Note: 

You cannot call this function from a C program. You must call it from 
an assembly language program by using the EXGPC instruction. 


The single-precision arguments are passed via registers A9 and A10; the 
result is returned in A10. The prior contents of A7 through A12 are lost. 
The function is called with an EXGPC function using register A5. 




* Vector addition routine: add array x to array y. * 
**************************************************** 


LOOP: 


.global 

FL-ADD 

} 

MOVE 

*~A14,A0,1 

} 

MOVE 

*-A14,Al,l 

} 

MOVE 

*-A14,A2,l 

} 

MOVE 

*A1+,A9,1 

} 

MOVE 

*A2,A10,1 

} 

MOV I 

FL-ADD,A5 

} 

EXGPC 

A5 


MOVE 

A10,*A2+,1 

} 

DSJ 

AO,LOOP 

7 


declare function external 
get count 

get pointer to x array 
get pointer to y array 

get x[i] 
get y[i] 

put entry point in A5 

store sum of x[i], y[i] 
loop again if —count > 0 
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FL-COS 


Floating-Point Cosine Function 


Syntax 

Description 


Example 


.global FL_COS 

The FL—COS function calculates the cosine of a real number that repres¬ 
ents an angle expressed in radians. Both the input value and return value 
are single-precision floating-point values. 


Note: 

You cannot call this function from a C program. You must call it from 
an assembly language program by using the CALLA instruction. 


The single-precision argument to this function is passed via register A10 
and the result is returned in A10. The prior contents of A10 and A8 are 
lost. 


.global FL_COS 
MOVE *AH-,A10,1 

CALLA FL^COS 


;declare function external 
;get angle in AlO 
;returns cos(angle) in AlO 





Floating-Point Multiply Function 


FL-MULT 


Syntax 

Description 


Example 


.global FL_MULT 

The FL—MULT function multiplies two single-precision floating-point 
values. The result Is also a single-precision floating-point value. Refer to 
discussion of single-precision floating-point format in Appendix D of the 
TMS34010 C Compiler User's Guide. 


Note: 

You cannot call this function from a C program. You must call it from 
an assembly language program by using the EXGPC Instruction. 


Arguments are passed to the function in registers A9 and A10, and the 
result is returned in A10. The prior contents of A9 through A12 are lost. 
The function is called with an EXGPC function using register A5. 


********************************************************** 

* Vector multiply routine: multiply array y by array x. 

* 




LOOP: 


.global 

FL-MULT 

MOVE 

*-A14,A0,l 

MOVE 

*-A14,Al,l 

MOVE 

*-A14,A2,l 

MOVE 

*AH-,A9,1 

MOVE 

*A2,A10,1 

MOV I 

FL-MULT,A5 

EXGPC 

A5 

MOVE 

A10,*A2+,1 

DSJ 

AO,LOOP 


declare function external 
get count 

get pointer to x array 
get pointer to y array 

get x[i] 
get y[i] 

put entry point in A5 

store x[i]*y[i] in y[i] 
loop again if “-count>0 
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FL~SIN 

Syntax 

Description 


Example 


Floating-Point Sine Function 


.global FL_SIN 

The FL—SIN function calculates the sine of a real number that represents 
an angle expressed in radians. Both the input value and return value are 
single-precision floating-point values. 


Note: 

You cannot call this function from a C program. You must call it from 
an assembly language program by using the CALLA instruction. 


The single-precision argument to this function is passed via register A10 
and the result is returned in A10. The prior contents of A10 and A8 are 
lost. 


.global FL_SIN 
MOVE *A1+,A10,1 

CALLA FL-SIN 


declare function external 
get angle in AlO 
returns sin(angle) in AlO 
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Float to Fixed Point Function 


float—to—fix 


Syntax fix *float_to—fix(n, in—array, out—array) 

typedef long FIX; /* put this before function */ 

/* definition */ 

int n; /* number of elements to be */ 

/* converted */ 

float in_array[]; /* array of float values */ 


FIX out_array[]; /* array of fixed-point values */ 

Description The float—to~fix function converts an array of single-precision floating¬ 
point values to fixed-point values. Elements of the input array are of type 
float. Elements of the output array are 32-bit, 2s complement, fixed-point 
numbers with the binary point located between the 16 LSBs and 16 
MSBs. The input arguments include: 

• The number of elements n that are converted, 

• The input array in_array, and 

• The output array out—array. 

A pointer to the first element of the output array Is returned. 

Example typedef long FIX; 

static float xyzl[9] = { 

0.,-58.,0., 50.,29.,0., -50.,29.,0. 

}; 

FIX xyz2[9]; 

float_to—fix(9, xyzl, xyz2); 
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floor 


Floor Function Function 


Syntax 

Description 

Example 


double floor(x) 
double x; 

The floor function returns a double-precision floating-point number re¬ 
presenting the largest integer less than or equal to the Input argument x. 

extern double floor(); 
double answer; 

answer = floor(3.1415, &exp); 

/* after execution, answer will be 3.0 */ 
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Remainder Function 


fmod 


Syntax 

Description 


Example 


double fmod(x, y) 
double X, y; 

The fmod function calculates the floating-point remainder of x/y. The 
input arguments and return value are all double-precision floating-point 
numbers. If the quotient x/y cannot be represented, the result is unde¬ 
fined, and the floating-point error routine fp—error is called. Otherwise, 
the function returns the value x-/*y, where / is an integer such that, if y 
is nonzero, the result has the same sign as x and a magnitude less than the 
magnitude of y. 

If input argument y is 0, the return value is 0, and an error code of 8 is 
transmitted to the fp—error routine. If input argument x is +ao or -oo, the 
return value is 0, and an error code of 9 is transmitted to fp—error (see the 
floating-point description in the TMS34010 C Compiler User's Guide). 

/****************★*********************/ 

/* fmod returns double result */ 

/**************************************/ 
extern double fmod(); 
double X, y, r; 

X = 1.0; 
y = 2.0; 

r = fmodCx, y); /* fmod returns 1.0 */ 
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frame—oval 


Frame Oval Function 


Syntax 


Description 


Example 


void frame—oval(w, h, xleft, ytop, dx, dy) 

int w, h; /* width and height of */ 

/* enclosing rectangle */ 
int xleft, ytop; /* coordinates at top */ 

/* left corner */ 

int dx, dy; /* width and height of */ 

/* frame border */ 

The frame—oval function solid-fills an ellipse-shaped frame with the cur¬ 
rent C0L0R1. The frame consists of a filled region between two con¬ 
centric ellipses. The portion of the screen enclosed by the frame Is not 
altered. 

The outer ellipse is specified In terms of the minimum enclosing rectangle 
in which it is circumscribed. The first four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xlef t,ytop). 

The thickness of the frame in the X and Y dimensions Is defined by two 
additional arguments, dx and dy, which specify the horizontal and vertical 
distances, respectively, between the outer and inner ellipses. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, dx, dy; 

init—video(1); 
init—grafix(); 
init—screen(); 
w =480; 
h = 360; 

X = 80; 
y =60; 
dx = 40; 
dy = 30; 

frame—oval(w, h, x, y, dx, dy); 
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Frame Rectangle Function 


frame—rect 


Syntax 


Description 


Example 


void frame—rect(w, h, xleft, ytop, dx, dy) 

int w, h; /* width and height of */ 

/* enclosing rectangle */ 

int xleft, ytop; /* coordinates at top */ 

/* left corner */ 

int dx, dy; /* width and height of */ 

/* frame border */ 

The frame—rect function solid-fills a rectangular frame with the current 
C0L0R1. The frame consists of a filled region between two concentric 
rectangles. The portion of the screen enclosed by inner edge of the frame 
is not altered. 

The first four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The thickness of the frame in the X and Y dimensions is defined by two 
additional arguments, dx and dy, which specify the horizontal and vertical 
distances, respectively, between the outer and inner rectangles. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, dx, dy; 


init—video(1); 
init_grafix(); 
init—screen(); 
w = 480; 
h = 360; 

X = 80 ; 
y = 60; 
dx = 40; 
dy = 30; 
frame—rect(w, h 


X, y, dx, dy); 
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frexp 


Fraction and Exponent Function Function 


Syntax 


Description 


Example 


double frexp(value, exp) 

double value; /* input floating-point number */ 
int *exp; /* pointer to exponent */ 

The frexp breaks a double-precision floating-point number into a normal¬ 
ized fraction and an exponent The fraction is returned by the function, 
and the exponent is placed in the integer pointed to by exp. 

extern double frexp(); 

double fraction; 
int exp; 


fraction = frexp(3.1415, &exp); 

/* after execution, fraction will be .1415, and 
exp will contain 3 */ 




Get All Palette Function 


getall—palet 


Syntax 


Description 


Example 


void getall—palet(palet—array, reg—mask, y) 

short palet—array[16]; /* palette reg. values */ 

int reg—mask; /* register-select mask */ 

int y; * scan line */ 

The getall—palet function reads multiple color palette registers into the 
destination array. The purpose of this function is to make selected palette 
register values available for Inspection and modification. This function 
assumes a TI\/IS34070 color palette or functional equivalent The pixel 
size is therefore four bits, and the palette contains 16 registers. The values 
contained In the palette registers can change on a line-by-line basis. 

Each 16-blt palette register is organized according to the following format 


15 12 

11 8 

7 4 

3 0 

biu 

grn 

red 

att 


MSB LSB 


The red, green, and blue intensity fields are 4-bit, unsigned binary num¬ 
bers. The attribute field contains a color-repeat bit that is set to one to 
enable automatic filling by the palette device. See the TMS34070 User's 
Guide for details. 

• The first argument, palet—array, is the array Into which the register 
values from the color palette are written. 

• The second argument, reg—mask, specifies which of the 16 palette 
registers are written to the destination array. Bit positions 0 to 15 
in the mask enable (if 1) or disable (if 0) writing the corresponding 
palette registers. For example, a mask value of 001710 enables 
writing of palette registers 0, 1,2 and 4 into palet-array elements 
0, 1,2 and 4. 

• The third argument, y, designates at which scan line the color palette 
is examined. This argument Is necessary because the palette can 
differ from line to line. Scan lines are numbered in ascending order 
beginning with 0 at the top of the screen. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


short temp—array[16]; 

/****************************************/ 
/* Copy palette registers 5, 6, 8 and 9 */ 
/* from the 18th scan line */ 

/****************************************^ 

getall—palet(temp—array, 0x0360, 17); 
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get—ascent 


Get Ascent Function 


Syntax 

Description 


Example 


int get_ascent() 

The get—ascent function returns the value of the ascent parameter for the 
current font. The ascent value is the number of vertical pixels from the 
baseline to the top of the tallest character In the font. The ascent for the 
current font is defined in the font structure; the get—ascent function re¬ 
trieves the ascent value from the structure. 


Note: 

Before you call the get—ascent function, call the init—text function to 
initialize the text data structures. 


/* Draw text flush with top of screen */ 

/**************************************/ 
static char *s = "Hello world."; 
int w, h, X, y; 

init—video(1); 
init—grafix() ; 

init—text(); /* sets up default font */ 

init—screen(); 

X = y = 0; /* top left corner */ 

w = get—width(s); 
h = get—ascent(); 

set—color1(0x11111111); /* assume 4 bits/pixel */ 

fill—rect(w, h, x, y); 

transp—on(); 

set-colorl(0x77777777) ; 

draw—string(x, y+h, s); 
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Get Descent Function 


get—descent 


Syntax 

Description 


Example 


int get—descent() 

The get—descent function returns the value of the descent parameter for 
the current font. The descent descent is the the vertical distance measured 
in pixels from the baseline to the lowest descender in the character set. 
The descent for the current font is defined In the font structure; the 
get—descent function retrieves the descent value from the structure. 


Note: 

Before you call the get—descent function, call the init—text function to 
initialize the text data structures. 


/****^c******************************/ 

/* Draw line just below descenders */ 

^******************★****************/ 
static char *s = ’’jumping jimminy”; 
int w, h, X, y; 

init—video(1) ; 
init—grafix(); 

init—text(); /* sets up default font */ 

init—screen(); 

X = 0; 

y = get—ascent(); 
w = get—width(s); 
h = get—descent(); 
draw—string(X, y, s); 

set—color1(0x11111111); /* assume 4 bits/pixel */ 

fill—rect(w, 1, x, y+h); 
h = char—high() + 1; 
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get—first 

Syntax 

Description 


Example 


ch 


Get First Character Function 


int get—first—ch() 

The get—first—ch function returns the ASCII character code for the first 
character present in the current font All characters whose codes are less 
than the return value correspond to "missing" characters; that is, their 
character images are omitted from the font structure. 


Note: 

Before you call the get—first-ch function, call the init—text function to 
initialize the text data structures. 


/***************************************************/ 
/* Draw all characters implemented in current font */ 
*********************************************** 

unsigned char c; 
int X, y; 

init—video{1) ; 
init—grafix() ; 

init—text(); /* sets up default font */ 

init—screen(); 

X = 10; 
y = 100; 

for (c = get—first—ch(); c <= get—last—ch(); 

++C, X += char—wide-jnax ( ) ) { 

if (x > 640) { 

X = 10; 
y += 50; 

} 

draw—char(x, y, c) ; 

} 
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Get Font Maximum Function 


get—font—max 


Syntax 

Description 

Example 


int get—font—max() 

The get—font—max function returns the maximum number of fonts that 
can be installed simultaneously (see the description of the install—font 
function also). If a value of n is returned, font indices can range from 0 
to A7-1 . 


int n; 

n = get—font—max(); 
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get—last—ch 


Get Last Character Function 


Syntax 

Description 


Example 


int get—last_ch () 

The get—last—ch function returns the ASCII character code for the last 
character present in the current font. All characters whose codes are 
greater than the return value correspond to "missing" characters; that is, 
their character images are omitted from the font structure 


Note: 

Before you call the get~last—ch function, call the in it—text function to 
Initialize the text data structures. 


/*****************★*********************************/ 
/* Draw all characters implemented in current font */ 

/***************************************************/ 
unsigned char c; 
int X, y; 

init—video{1); 
init—grafix(); 

init—text(); /* sets up default font */ 

init—screen(); 

X = 10; 
y = 100; 

for (c = get—first—ch(); c <= get—last— ch () ; 

++C, X += char—wide—max ()) { 

if (x > 640) { 

X = 10 ; 
y += 50; 

} 

draw—char(x, y, c); 

} 
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Get Leading Function 


get—leading 


Syntax 

Description 


Example 


int get—leading() 

The get—leading function returns the leading value for the current font. 
The leading is the empty space between rows of text; that is, it is the 
number of vertical pixels from the lowest descenders of one row of text to 
the tallest characters of the line of text below it. This function retrieves the 
leading value from the font structure. 


Note: 

Before you call the get—leading function, call the init—text function to 
initialize the text data structures. 


/**********************************************^ 
/* Draw lines between successive rows of text */ 

/**********************************************/ 
static char s[] = ’’The quick brown fox..."; 
int X, y, dx; 


init—video(1); 
init—grafix(); 

init—text(); /* sets up default font */ 

init—screen(); 
transp—on(); 

dx = (640 - get—width(s)) / (480 / char—high()); 
for (x = 0, y = get—ascent(); y < 480; 

X += dx, y += char—high()) { 
draw—string(X, y, s); 

fill—rect(640, 1, 0, y + get—descent() + 

get—leading0/2) ; 


} 
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get—patn—max 


Get Pattern Maximum Function 


Syntax 

Description 

Example 


int get—patn—max () 

The get—patn—max function returns the maximum number of patterns that 
can be installed at any one time. If return value Is n, available range of 
vertices Is 0 to nA . The maximum number of patterns is a function of the 
size of the pattern table data structure. 

int w, h, X, y, dx, dy, pmax, patn; 
init—video(1); 

init—grafix(); /* Install default patterns */ 

init—screen(); 

set—colorO(0x11111111); /* Assume 4 bits/pixel */ 

^**********************************/ 

/* Display all available patterns */ 

/***************★******************/ 

pmax = get—patn_max(); 

X = y = 0; 
w = 84; 
h =68; 
dx =96; 
dy = 80; 

for (patn = 0; patn < pmax; select—patn (++patn) ) { 

patnfill—rect(w, h, x, y); 
if ((x += dx) > 640 - w) { 

X = 0; 

y += dy; 

} 

} 




Get Pixel Value Function 


get—pixel 


Syntax 

Description 


Example 


int get_pixel(x, y) 

int X, y; /* coordinates of pixel */ 

The get—pixel function returns the value of the pixel at coordinates (x,y). 
The coordinates are relative to the viewport origin. Given a pixel size of 
n bits, the pixel is contained in the n LSBs of the return value (the MSBs 
are Os). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int xs, ys, xd, yd; 

static char s[] = "topsy turvy”; 

short buf[640/4]; /* line buffer for zoom */ 

init—video(1); 
init—grafix(); 
init—text(); 
init—screen(); 

draw—string(0, get—ascent(), s); 

^*********************************/ 

/* Flip and mirror original text */ 

/*********************************/ 

for (ys = 0, yd = 29; ys <= 19; ++ys, --yd) 

for (xs =0, xd = 89; xs <= 89; ++xs, --xd) 
put—pixel (get—pixel(xs, ys) , xd, yd); 
zoom-rect{40, 40, 0, 0, 160, 160, 240, 160, buf); 
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get—pmask 


Get Plane Mask Function 


Syntax 

Description 


Example 


long get_pmask() 

The get—pmask function returns the value of the plane mask (TMS34010 
PMASK register). Although only the 16 LSBs of the PMASK register are 
implemented in the TMS34010, the plane mask is 32 bits for the sake of 
upward compatibility with future GSPs. 

The plane mask designates which bits within a pixel are protected against 
writes, and affects ail operations on pixels. The protected bits are repli¬ 
cated throughout the 32-blt plane mask in a manner similar to that used 
for the COLORO and COLOR1 values. The Is in the plane mask specify 
protected bits in the destination pixel that cannot be modified, while the 
Os specify bits that can be altered. The plane mask can be altered by me¬ 
ans of a call to the set—pmask function. See the TMS34010 User's Guide 
for a further discussion of plane masking. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 


long mask; 

/* Assume pixel size is 4 bits */ 
init—video(1); 

/* sets PMASK = all Os */ 

init—grafix(); 

set—pmask(0x11111111) ; 

/* Write protect pixel bit #0 */ 

mask = get—pmask(); 

/* Return value = 0x00001111 */ 
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Get Pixel Processing Operation Function 


get—ppop 


Syntax 

Description 


Example 


long get—ppop() 

The get—ppop function returns the code for the current pixel processing 
operation (the PPOP field in the TMS34010's CONTROL register). The 
5-bit PPOP code resides in the 5 LSBs of the return value; all higher order 
bits are Os. 

The PPOP code determines the manner in which pixels are combined 
(logically or arithmetically) during drawing operations. A new PPOP code 
can be selected by means of the set—ppop function. Legal PPOP codes 
are in the range 0 to 21. The effects of the 22 different codes are de¬ 
scribed in the TMS34010 User’s Guide. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 


long ppop; 

init_video(1); /* PPOP = all Os (REPLACE) */ 

init—grafix(); 

set—ppop(10); /* select XOR */ 

ppop = get—ppopO; /* returns PPOP = 10 */ 
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get—psize 


Get Pixel Size Function 


Syntax 

Description 


Example 


int get—psize() 

The get—psize function returns the pixel size (contents of TMS34010 
PSIZE register). The pixel size for the display system Is typically a con¬ 
stant defined within the Init—video function. The TMS34010 supports 
pixels of 1,2, 4, 8, and 16 bits. Future GSPs may support additional pixel 
sizes. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


long psize; 

init—video(1); /* sets PSIZE */ 

init—grafix(); 
psize = get—psize(); 
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Get Rectangle Function 


get—rect 


Syntax 


Description 


void get—rect(w, h, xleft, ytop, darray, dpitch) 


int 


w, h; 


int xleft, ytop; 

short darray[] 
long dpitch; 


/* 

/* 

/* 


width and height of */ 
source rectangle */ 
coordinates at top left */ 
corner */ 
destination pixel array */ 
destination pitch */ 


The get—rect function copies pixels contained in a rectangular area of the 
screen into a packed pixel array. The first four arguments define the source 
rectangle (the rectangular area of the screen): 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 
w and h must be nonnegative. 

The last two arguments describe the destination array: 

• The destination array, darray, and 

• The pitch of the array, dpitch. 

The array pitch is the difference In the starting addresses of two adjacent 
pixel rows of the array. The pitch must be a positive multiple of the pixel 
size. The minimum pitch is the product of w and the pixel size. The pixel 
size can be obtained by calling the get—psize function. The destination 
array must be large enough to contain the source array. The minimum 
number of bits required In the destination array Is the product of h and 
dpitch. 

The source rectangle is clipped to positive XY coordinate space before 
being copied. Portions of the source array lying In negative XY space are 
not copied, and the corresponding portions of the destination array remain 
unaltered. Portions of the source array lying outside the current viewport 
and clipping rectangle are not clipped unless they lie in negative XY 
space. 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 
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get—rect 


Example 


Get Rectangle Function 


int w, h, X, y, pitch, i; 
short buf[80*60*4/16]; 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 80; 
h = 60; 

X = 280; 
y = 210; 

pitch = w * get—psize(); 

/*** Draw picture ***/ 
fill—rect(w-2, h-2, x+1, y+1); 

set—colorO(0x11111111); /* Assume 4 bits/pixel */ 

set—color1(0x44444444); 

patnframe—oval(w-2, h-2, x+1, y+1, 20, 15); 

/*** Capture picture from screen ***/ 
get—rect(w, h, x, y, buf, pitch); 

/*** Put picture onto screen ***/ 

for (i = 25, X = 0, y = -150<<16; i > 0; --i) { 

X += y >> 2; 
y “= X >> 2; 

put—rect(buf, pitch, w, h, (x>>16)+280, (y>>16)+210); 
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Get Transparency Function 


get—transp 


Syntax 

Description 


Example 


int get—transp() 

The get—transp function returns the state of the transparency enable bit 
(the T bit from the TMS34010's CONTROL register). A value of 1 is re¬ 
turned if transparency is enabled; otherwise, 0 is returned. 

Transparency Is an attribute that affects text drawing and pattern fills. If 
transparency Is enabled, and the result of a pixel processing operation is 
0, the destination pixel is not altered. If transparency Is disabled, the 
destination pixel Is replaced by the result of the pixel processing operation 
regardless of the value of that result. See the TMS34010 User's Guide for 
a further discussion of transparency. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


int t; 

init—video(1) ; 
init—grafix(); 
t = get—transp(); 
transp—on(); 
t = get—transp(); 


/* Disables transparency 
/* Return value = 0 
/* Return value = 1 


V 

V 

V 


5-77 





get—vuport—max 


Get Viewport Maximum Function 


Syntax 

Description 

Example 


int get_vuport—max() 

The get—vuport—max function returns the maximum number of viewports 
that can be open at any one time. If the return value is a number n, the 
range of indices for available viewports is 0 to /?-1. 

int V; 

init—video(1); 
init—grafix(); 
init—vuport(); 

V = get—vuport_max(); 


5-78 




Get Width of String Function 


get—width 


Syntax 

Description 


Example 


int get—width(s) 

char *s; /* ASCII char string terminated by NULL */ 

The get—width function returns the width of a character string s. The 
width is the number of pixels from the left edge to the right edge of the 
string, where the string is drawn in the current font. The spacing between 
characters is included in this number, including any adjustments to the 
font's default spacing due to a previous call to the add—text—space func¬ 
tion. 

The character string is in standard C format; that is, the string is a se¬ 
quence of ASCII character codes terminated by a NULL (ASCII code = 
0 ). 


Note: 

Before you call the get—width function, call the init—text function to 
initialize the text data structures. 


#include "fntstruc.h" 

#define XC 320 
#define YC 240 

extern FONT corpus—christi29; 
static char *s[] = { 

"The get—width function", 

"is easily used", 

"to center text", 

"on your screen." 

} ; 

int X, y, i; 

init—video(1); 

init—grafix(); 

init—text(); 

init—screen(); 

set—color1(0x11111111); 

draw—line(XC, 0, XC, 2*YC); /* crosshairs */ 

draw-line(0, YC, 2*XC, YC); 

install—font(1,Scorpus—christi29); 

y = YC - 4*char—high()/2 + get—ascent(); 

transp—on(); 

set-colorl(0x33333333); 

for (i = 0; i <= 3; ++i) C 

X = XC -« get—width(s[i])/2; 

draw—string(x, y, s[i]); /* centered text */ 

y += char—high(); 

} 
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init—grafix 


Initialize Graphics Function 


Syntax 

Description 


Example 


void init—grafix() 

The init—grafix function initializes the graphics environment. It sets up the 
data structures for the graphics functions, and assigns default values to 
system parameters. You should call this function before performing any 
graphics or text drawing operations. 


Note: 

Call the Init—video function before you call the init—grafix function. 


The init—grafix function performs these tasks: 

• Disables pixel transparency. 

• Sets pixel processing operation to replace. 

• Enables all color planes (PMASK all Os). 

• Moves XY origin to default position at top left corner of screen. 

• Sets visibility rectangle (clipping window) to full screen. 

• Sets drawing pen to default size. 

• Initializes pattern data structures, and installs default patterns. 


int X, y, i; 

init—video(1); /* Initialize video */ 

init—grafix(); /* Initialize graphics */ 

init—screen(); /* Initialize screen */ 

/*** Ready to draw something... ***/ 

for (i = 100, X = 0, y = 200<<16; i > 0; --i) { 

draw-line(320, 240, 320+(x>>16), 240+(y>>16)); 
X += y >> 4; 
y -= X >> 4; 

} 
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Initialize Matrix Function 


in it—matrix 


Syntax 

Description 


void init—matrix (matrix) 
typedef long FIX; 

FIX matrix[16]; 


The init—matrix function initializes a 16-element fixed-point array to a 
4x4 identity matrix. The format used for a 32-bit 2s complement fixed- 
point value places the binary point between the 16 LSBs and 16 MSBs. 
A fixed-point value of 1 can be represented In C as long Integer constant 
0 x 10000 . 

The resulting identity matrix Is ready to be transformed by the rotate, scale 
and translate functions. See Principles of Computer Graphics (Newman 
and Sproull) for a detailed discussion of homogeneous 3D transf¬ 
ormations. 

The matrix elements are mapped into the array in row-major order as fol¬ 
lows: 


matrix[0] = 1; 
matrix[1 ] = 0; 
matrix[2] = 0; 
matrix[3] = 0; 

matrix[4] = 0; 
matrix[5] = 1; 
matrix[6] = 0; 
matrix[7] = 0; 

matrix[8] = 0; 
matrix[9] = 0; 
matrix[10]= 1; 
matrix[11 ]= 0; 

matr ix[1 2]= 0; 
matrix[13}= 0; 
matr ix[1 4}= 0; 
matrix[1 5}= 1; 


matrix element ago 
matrix element agt 
matrix element ao 2 
matrix element aga 

matrix element a-jg 
matrix element a-i ^ 
matrix element a'i 2 
matrix element a -13 

matrix element a 2 g 
matrix element a 2 i 
matrix element a 22 
matrix element a 23 

matrix element a^o 
matrix element a 3 i 
matrix element a 32 
matrix element a 33 


begin 1 st row 


begin 2 nd row 


begin 3rd row 


begin 4th row 
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init—matrix 


Initialize Matrix Function 


Example 


typedef long FIX; 

static FIX rotation[3] = { 0, 0, 0 }; 

static FIX translatl[3] = { -320, -240, 0 } ; 

static FIX translat2[3] = { 320, 240, 0 }; 

static long xyz[] = { 

320,40,0, 340,240,0, 320,260,0, 300,240,0 

}; 

static short connect[8] = { 0,1, 1,2, 2,3, 3,0 }; 
FIX matrix[16]; 

FIX verts[12]; 
short xy[8] ; 
int angle; 

init—video(1); 
init_grafix(); 

long_to—fix{3, translatl, translatl); 
long—to_fix(3, translat2, translat2); 
for (;;) 

for (angle = 0; angle < 360; ++angle) { 
init—matrix(matrix); 
translate(matrix, translatl); 
rotation[0] = angle << 16; 
rotate(matrix, rotation); 
translate(matrix, translat2); 
long—to—fix(12, xyz, verts); 
transformimatrix, 4, verts); 
vertex—to—point(4, verts, xy); 
delay(0) ; 
init—screen() ; 

draw-oval(420, 420, 110, 30); 
draw—polyline(4, connect, xy); 

} 


5-82 




Initialize Palette Function 


init—palet 


Syntax 

Description 


Example 


void init_palet() 

The init—palet function initializes the color look-up table to default palette 
values. 


Note: 

Call the init—video and init—grafix functions before you call the 
init—palet function. 


The results of this function are system dependent. In the case of the 
TMS34010 software development board, the pixel size is four bits, and the 
TMS34070 color palette contains 16 registers. When the SDB is config¬ 
ured for analog RGB output, the following default colors are assigned to 
pixel values 0 to 15 by the init—palet function: 


Pixel Value 

Color 

Pixel Value 

Color 

0 

black 

8 

black 

1 

red 

9 

light red 

2 

green 

10 

light green 

3 

yellow 

11 

light yellow 

4 

blue 

12 

light blue 

5 

magenta 

13 

light magenta 

6 

cyan 

14 

light cyan 

7 

white 

15 

gray 


The current implementation of the init-palet function assumes that the 
TMS34070 color palette is configured in line-load mode (see TMS34010 
Software Development Board User's Guide for description of hardware 
jumper options). The default palette is updated over the entire screen. 

long w, h, x, y, c, dc; 

init—video(1); /* Configure SDB for analog output */ 

init—grafix(); 
init—text(); 

clear—screen(0); /* Fill frame buffer with Os */ 

init—palet (); /* Install default color palette */ 

c = 0; 

dc = 0x11111111; 
w = 30; 
h = 440; 

for (x = 5, y = 30; x < 639; x -i-= 40, c += dc) { 
set—color1(c); 
fill—rect(w, h, x, y) ; 
set-colorl(0x77777777); 
draw—rect(w+1, h+1, x-l, y-1); 

} 

draw—string(5, 20, "Default Color Palette"); 







in it—screen 


Initialize Screen Function 


Syntax 

Description 


Example 


void init—screen() 

The init—screen function initializes the screen. The entire frame buffer is 
cleared (filled with Os). If the system contains a color lookup table, the 
table Is loaded with the default color palette. 


Note: 

Call the init—video and init—grafix functions before you call the 
init—screen function. 


The implementation of this function is system-dependent. In the case of 
a TMS34010 software development board configured for analog output, 
the RGB signals to the monitor are assumed to be generated by a 
TMS34070 color palette configured In line-load mode (see the 
TMS34010 Software Development Board User's Guide for a description 
of hardware jumper options). The Init—screen function loads the palette 
region of the frame buffer (the first 256 bits of each scan line) with default 
color values, and clears the remainder of the frame buffer to Os. If the SDB 
Is instead configured for digital output, the TMS34070 Is not used, and 
the init—screen function fills the entire frame buffer with Os. 

long w, h, x, y, c, dc; 

init—video(1); /* Configure SDB for analog output 

V 

init—grafix(); 
init—text(); 

init—screen (); /* Clear screen, load default palette 

V 

c = 0 ; 

dc = 0x11111111; 
w =30; 
h = 440; 

for (x = 5, y = 30; x < 639; x += 40, c += dc) { 
set—color1(c); 
fill—rect(w, h, x, y); 
set-colorl(0x77777777); 
draw—rect(w+1, h+1, x-l, y-1); 

} 

draw—string(5, 20, "Default Color Palette"); 
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Initialize Text Function 


in it—text 


Syntax void init_text() 

Description The init—text function initializes text data structures, and installs the de¬ 
fault "system" font as font number 0. The additional text spacing incre¬ 
ment Is initialized to 0, but can be modified by a call to the 
add—text—space function. 

Call the Init—text function before you call any of the following functions: 

add—text—space get—first—char 

char—high get—last—char 

char—wide—max get—leading 

• draw—char get—width 

draw—string install—font 

get—ascent select—font 

get—descent 

Example #include "fntstruc.h” /* Define FONT type */ 

#define XC 320 

#define YC 240 

extern FONT corpus—christi29; 

static char s[] = "34010”; 

int X, y; 

init_text(); /* Initialize text */ 

init—video(1); /* Initialize video */ 

init—grafix(); /* Initialize graphics */ 

init—screen(); /* Initialize screen */ 

install—font(1, &corpus—christi29); /* Remember the & */ 

y = YC + get—ascent()/2; 

X = XC - get—width(s)/2; 

draw—string(x, y, s); /* center text */ 
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init—video 


Initialize Video Function 


Syntax 

Description 


int init—video (monitor_val) 

int monitor—val; /* display monitor type */ 

The init—video function initializes video display by setting up the 
TMS34010's video timing and screen refresh registers to drive a display 
monitor. This function Initializes all system-dependent portions of the 
graphics environment. The other initialization routines (init—grafix, 
Init—text, and init—vuport) Initialize system-//?dependent portions of the 
graphics environment. 

Argument monitor_val specifies the type of monitor present. Arguments 
In the range 1 to 5 are currently supported, but the init—video function 
may be enhanced In the future to support additional monitor types. 
Monitor types that are currently supported Include: 


monitor—val 

Display Configuration 

1 

Sets up the SDB to drive an analog RGB monitor for 640x480 re¬ 
solution. Video crystal = 25 MHz. Monitors compatible with this 
configuration are: 

“■ Princeton Graphics SR-12P Analog RGB 
” NEC JC-1401 P3A Multi-Sync Analog RGB 
“ Sony CPD-1302 Multi-Scan Analog RGB 

Noninterlaced display with 60-Hz frame rate. Also assumes 
TMS34070 palette in line-load mode. 

2 

Sets up the SDB to drive an analog RGB monitor for 640x480 re¬ 
solution. Video crystal = 25 MHz. Monitors compatible with this 
configuration are: 

- IBM 5175 Professional Graphics Display 

Noninterlaced display with 60-Hz frame rate. Also assumes 
TMS34070 palette in line-load mode. 

3 

Sets up the SDB to drive a TTL RGB monitor for 720x300 resol¬ 
ution. Video crystal = 18 MHz. Monitors compatible with this co¬ 
nfiguration are: 

- Tl PC Color Display Monitor 

Noninterlaced display with 60-Hz frame rate. Assumes SDB con¬ 
figured for TTL RGB output levels. 

4 

Sets up the SDB to drive a TTL RGB monitor for 720x512 resol¬ 
ution. Video crystal = 18 MHz. Monitors compatible with this co¬ 
nfiguration are: 

- Tl PC Color Display Monitor 

Interlaced display with 30-Hz frame rate. Assumes SDB configured 
for TTL RGB output levels. 

5 

Sets up the SDB to drive an analog RGB monitor 448x480 resol¬ 
ution. Video crystal = 25 MHz. This configuration Is used to pro¬ 
vide double buffering, and is compatible with these monitors: 

“ Princeton Graphics SR-12P Analog RGB 

- NEC JC-1401 P3A Multi-Sync Analog RGB 

- Sony CPD-1302 Multi-Scan Analog RGB 

Noninterlaced display with 60-Hz frame rate. Assumes SDB con¬ 
figured for analog RGB output. 
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Initialize Video Function 


init—video 


Note: 

Call the init—video function before calling the init—grafix or init—vuport 
function. 


If an invalid argument is received, the function returns a value of -1 and 
aborts. If the argument is valid, the function returns a value of 0 as confir¬ 
mation. 

The init—video function performs these tasks: 

• Sets up the horizontal and vertical video timing registers. 

• Sets up the screen refresh registers. 

• Defines screen horizontal and vertical dimensions. 

• Defines the memory locations of the screen and workspace buffers. 

• Sets the pixel size. 

• Sets COLORO and COLOR1 to their default values (black and white). 

• Sets up the DPTCH and CONVDP registers to the screen pitch. 

• Loads screen base address into OFFSET register (B4). 

• Sets up the default XY origin at top left of screen. 

• Sets the DPYTAP register to 0. 


Example 


int X, y, i; 

static char s[] = "Hello World."; 


init—text(); /* 
init—video(1); /* 
init—grafix(); /* 
init—vuport(); /* 
init—screen(); /* 


Initialize text */ 
Initialize video */ 
Initialize graphics */ 
Initialize vuport */ 
Initialize screen */ 


*** y 
0 ; 


— i) { 


set—origin(320, 240); 

/★** Ready to draw something... 
for (i = 101, X = 0, y = 200<<16; i 

draw—line{x>>17, y>>17, x>>16, y>>16); 

X -l-= y >> 4; 
y -= X >> 4; 

} 

draw—string(-get—width(s)/2, get—ascent()/2, s); 
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init—vuport 


initialize Viewport Function 


Syntax 

Description 


Example 


void init—vuport() 

The init—vuport function initializes the viewport data structures and opens 
viewport 0, the "system" viewport. All other viewports remain closed until 
they are explicitly opened. 


Note: 

Before you call this function, call the Init—grafix and Init—video func¬ 
tions. 


Call the init—vuport function before using any of the following viewport- 
specific functions: 

close—vuport set—origin 

move—vuport set—cliprect 

open—vuport size—vuport 

select—vuport 

Immediately after calling init—vuport, the coordinate origin Is located In the 
upper left corner of the screen, and the viewport and clipping rectangle 
encompass the entire screen. 


int index; 

init—video(1); /* Must precede init—vuport */ 

init—grafix(); 

init—vuportO; /* Opens viewport 0 */ 

index = open—vuport(); /* Opens 2nd viewport */ 

move—vuport(100, 100); 
size—vuport(200, 150); 

patnfill—rect(999, 999, 0, 0); /* Fills viewport */ 
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Install Font Function 


install—font 


Syntax 


Description 


Example 


int install—font(index, fontname) 

int index; /* index to be assigned to font */ 

FONT ^fontname; /* font structure */ 

The install—font function installs a font structure in the font table. The font 
structure contains the character bitnnap and other information necessary to 
extract the individual character patterns from the bitmap. (See the 
TMS34010 Font Library User's Guide for more information about the font 
structure.) The Installed font becomes the current font and it Is selected for 
subsequent text operations. 

The font structure itself Is not copied into the font table. Instead, a pointer 
to the font structure is Inserted into the font table in the position Indicated 
by argument index. This index identifies the font in subsequent trans¬ 
actions. Argument fontname is the pointer to the font structure. 

The maximum number of fonts n that can be simultaneously installed is 
obtained from the get—font—max function. The legal range of indices Is 0 
to /7-1. A value of -1 is returned if index Is out of range; otherwise, a value 
of 0 is returned. 


Note: 

Before calling the Install—font function, call the init—text function to 
initialize the text data structures. 


#include "fntstruc.h" 

extern FONT corpus—christi29; /* Corpus Christi font */ 


init—video(1); 
init—grafix{); 
init—text(); 
init—screen(); 
install—font(1, 
draw—string(50, 


/* default font = corpus—christilG */ 

Scorpus—christi29); /* Don't forget & */ 
100, "Hello world."); 
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install—patn 


Install Pattern Function 


Syntax 


Description 


Example 


int install—patn(index, pattern) 
int index; 
short pattern[16]; 

The install—patn function installs a pattern In the pattern table. The 256 
bits of the 16x16 two-dimensional bit map are copied Into the pattern table 
location Indicated by index. The index argument Identifies the pattern 
in subsequent transactions. Argument pattern is a pointer to the pattern 
bitmap. This pattern becomes the current pattern and It Is selected for 
subsequent pattern filling operations. 

When the installed pattern is later drawn to the screen, the Os In the pattern 
are replaced with the current COLORO, and the Is in the pattern are re¬ 
placed with the current COLOR1. 

The maximum number of patterns n that can be simultaneously installed Is 
obtained from the get—patn—max function. The legal range of indices is 0 
to n-1 . A value of -1 is returned if index is out of range. Otherwise, a value 
of 0 is returned. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


typedef enum { FIELDWIDTH = 1 } BIT; 
static BIT mypatn[] = { 

0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 1 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 
0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 
0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 
0 , 1 , 1 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 1 , 1 , 0 , 
0 , 0 , 1 , 1 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 1 , 1 , 1 , 0 , 0 , 
0 , 0 , 0 , 1 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 1 , 0 , 0 , 0 , 
0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 

}; 


V 

V 

V 


/* Installs default patterns 


init—video(1); 
init—grafix(); 
init—screen(); 
install_patn(5, mypatn); / 
set—colorO(0x11111111); / 

set—color1(0x33333333); / 

patnfill—rect(448, 288, 96 


Assign index = 5 
Expand Os to this color 
Expand Is to this color 
96) ; 
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Multiply Double by Power of Two Function 


Idexp 


Syntax 


Description 


Example 


double Idexp(value, exp) 
double value; 
int exp; 

The Idexp function returns value multiplied by 2 raised t the power of 
exp, and is commonly used to rebuild a double-precision floating-point 
value. 

extern double ldexp(); 

double value,result; 
int exp; 

value = 1.5; 
exp = 5; 

result = ldexp(value,exp); 

/* after execution, result will contain 48.0 */ 




lib—id Library Identifier Function 


Syntax char *lib—id() 


Description The lib—id function returns character string identifying library and revision. 


Example in it—video (1) ; 

init—grafix() ; 
init—text(); 
init—screen(); 

draw—string(50, 200, lib—id()); 
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Leftmost One Function 


Syntax 

Description 

Example 


I mo 


int Inio(n) 

long n; /* 32-bit integer */ 

The Imo function calculates the bit number of the leftmost one in argument 
n. The argument is treated as a 32-bit number whose bits are numbered 
from 0 to 31, where bit 0 is the LSB (the rightmost bit position) and bit 31 
is the MSB (the leftmost bit position). 

For nonzero arguments, the return value is in the range 0 to 31. If the ar¬ 
gument is 0, a value of -1 is returned. 

int i; 

init—video (1) ; 
init_grafix() ; 
init—screen(); 
for (i = 1; i < 640; ++i) 

draw—line(i, i, 1 << Imo(i), i); 
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log _ 

Syntax 

Description 

Example 


Natural Logarithm Function 


double log(x) 
double x; 

The log function calculates the natural logarithm of real number x. Both 
the argument x and the return value are double-precision floating-point 
values. 

If argument x is less than or equal to 0, a value of -oo Is returned, and 
fp—error is called with an error code of 26 (see the TMS34010 C Compiler 
User's Guide for a description of the fp—error function). 

extern double log()f 
float X, y; 

X = 2.718282; 

y = log(x); /* Return value = 1.0 */ 
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Common Logarithm Function 


Iog10 


Syntax 

Description 

Example 


double loglO(x) 
double x; 

The loglO function calculates the logarithm to the base 10 of x. Both the 
argument x and the return value are double-precision floating-point values. 

If argument x is less than or equal to 0, a value of -oo is returned, and 
fp—error is called with an error code of 26 (see the 1MS34010 C Compiler 
User's Guide for a description of the fp—error function). 


extern double logl0(); 
float X, y; 


X = 10.0; 
y = loglO(x); 


/* Return value = 1.0 */ 




long—to—fix 


Long to Fixed Point Function 


Syntax 


Description 


Example 


FIX *long_to—fix(n, in_array, out—array) 
typedef long FIX; 

int n; /* number of elements to be */ 


/* converted */ 

long in_array[]; /* array of integers */ 

FIX out_array[]; /* array of fixed-point */ 

/* values */ 


The long—to—fix function converts an array of long integers to fixed-point 
numbers. Elements of the input array are 32-bit 2s complement integers 
(C type long). Elements of the output array are 32-bit 2s complement 
fixed-point numbers with the 16 LSBs to the right of the binary point The 
conversion from integer format is done by simply shifting the elements left 
by 16 bits. 

The function requires three arguments: 

• The number of elements n that are converted, 

• The Input array in_array, and 

• The output array out_array. 

The value returned by the function is a pointer to the output array, 

out_array. 


typedef long FIX; 

static short triangle[] = (0,1, 1,2, 2,0}; 
static long xyzl[9] = {0,-116,0, 100,58,0, -100,58,0}; 
FIX xyz2[9]; 

short xy[6]; 

init—video(1); 

init—grafix(); 

init—vuport(); 

set—origin(320, 240); 

init—screen(); 

long—to—fix(9, xyzl, xyz2); 

vertex—to—point(3, xyz2, xy); 

pen—polyline(3, triangle, xy); 
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Signed Integer and Fraction Function 


modf 


Syntax 


Description 


Example 


double modf(value, exp) 

double value; /* input floating point number */ 
int *exp; /* pointer to exponent */ 

The modf function breaks a double-precision floating-point value into a 
signed fraction and a signed integer. The integer is stored at the integer 
object pointed to by exp, and the signed fractional value is returned. 

extern double modf(); 
double value, ipart, fpart; 
value = -3.1415; 
fpart = modf(value, Sipart); 

/* after execution, ipart will contain -3.0, and 
fpart will contain -0.1415 */ 
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move—pixel 


Move Pixel Function 


Syntax 


Description 


Example 


void move—pixel(xs, ys, xd, yd) 

int xs, ys; /* coordinates of source pixel */ 

int xd, yd; /* coordinates of destination pixel */ 

The move—pixel function copies a pixel from one screen location to an¬ 
other. Arguments (xs,ys) are the coordinates of the source location. Ar¬ 
guments (xd,yd) are the coordinates of the destination location. 
Coordinates are relative to the viewport origin. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


int xs, ys, xd, yd; 

static char s[] = ’’topsy turvy"; 

short buf[640/4]; /* line buffer (640x4 bits) */ 

init—video(1); 
init—grafix(); 
init—text(); 
init—screen(); 

draw—string(0, get—ascent(), s); 

/*** Flip and mirror original text ***/ 
for (ys =0, yd = 29; ys <= 19; ++ys, --yd) 

for (xs =0, xd = 89; xs <= 89; ++xs, --xd) 
move—pixel(xs, ys, xd, yd); 
zoom—rect(40, 40, 0, 0, 160, 160, 240, 160, buf); 
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Move Rectangle Function 


move—rect 


Syntax 


Description 


Example 


void move—rect(w, h, xs, ys, xd, yd) 

int w, h; /* width and height of */ 

/* rectangle */ 

int xs, ys; /* coordinates at top left */ 

/* of source */ 

int xd, yd; /* coordinates at top left */ 

/* of destination */ 

The move—rect function copies pixels from one rectangular region of the 
screen to another. 

• The first two arguments specify the width (w) and height (h) of the 
rectangle. These arguments must be nonnegative. 

• The source rectangle is located by the coordinates (xs,ys) of its top 
left corner. 

• The destination rectangle Is located by the coordinates (xd,yd) of Its 
top left corner. 

If a portion of the source rectangle lies in negative X or Y coordinate space, 
that portion is not copied; only the portion lying In positive XY space Is 
moved. Only the portion of the destination rectangle lying within the cur¬ 
rent visibility rectangle (the window corresponding to the intersection of 
the viewport and clipping rectangle) is modified on the screen. 

The rectangle is copied correctly even when the source and destination 
rectangles overlap. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


long w, h, xs, ys, xd, yd, i; 

init—video(1); 
init—grafix(); 
init—screen{); 
w = 80; 
h = 60; 
xs = 280; 
ys = 210; 

/******* Draw picture *******^ 

fill—rect(w, h, xs, ys); 

set—colorO(0x11111111); /* Assume 4 bits/pixel */ 

set—color1(0x44444444); 

patnframe—oval(w, h, xs, ys, 20, 15); 

/* Move picture to several places on screen */ 
for (i = 25, xd = 0, yd = ~150<<16; i > 0; --i) { 

xd += yd >> 2; 
yd -= xd >> 2; 

move—rect(w, h, xs, ys, (xd>>16)+280, (yd>>16)+210); 

} 
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move—vu port 


Move Viewport Function 


Syntax 

Description 


Example 


void move—vuport(xleft, ytop) 

int xleft, ytop; /* new position */ 

The move—vuport function moves the viewport to a new position on the 
screen. The viewport is rectangular. Its position is adjusted so that its top 
left corner coincides with the coordinates xleft and ytop. These coordi¬ 
nates are expressed as displacements from the screen origin, located at the 
top left corner of the screen. 


Note: 

Before you call the move—vuport function, call the Init—vuport function 
to initialize the viewport data structures. 


static char *s[] = { 

"Coordinate origin", 

"and clipping rectangle", 

"move with viewport." 

} ; 

int i, xtext, ytext, xvu, yvu; 

init—video(1); 
init—graf ix() ; 

init—vuportO; /* Initialize viewport 0 */ 

init—text(); 
init—screen(); 
set-colorO(OxCCCCCCCC); 

for (xvu = yvu = 0; xvu < 447; xvu += 8, yvu += 6) { 
move—vuport(xvu, yvu); 
set—color1(OxCCCCCCCC); 
fill-rect(192, 76, 0, 0); 
set—color1(0x44444444); 
frame—rect(188, 72, 2, 2, 4, 4); 
set_colorl(0x77777777) ; 
xtext = char—wide—max(); 
ytext = 12 + get—ascent(); 
for (i = 0; i <= 2; ++i) { 

draw—string(xtext, ytext, s[i]); 
ytext += char—high(); 

} 

} 
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New Screen Function 


new—screen 


Syntax 


Description 


Example 


void new—screen(pixel, palet) 
long pixel; 
short palet[16]; 

The new—screen function clears screen (entire frame buffer) to a specified 
pixel value, and loads the color look-up table with an array of palette values. 
The implementation of this function is system dependent, and relies on 
features of the TMS34070 color palette and TMS4161 video RAM. Video 
RAM register-to-memory cycles are used to make this function execute ra¬ 
pidly. 

The pixel value must be replicated throughout the 32 bits of the first argu¬ 
ment, pixel. For example, at four bits per pixel, a pixel value of 9 is repli¬ 
cated as follows: 0x99999999. 

The second argument, palet, is the array that contains the color palette. 
The array contains 16 elements, and each element Is 16 bits. The fields 
within each element of the palet array are defined as follows: 


15 12 

11 8 

7 4 

3 0 

blu 

grn 

red 

att 


MSB LSB 


Symbols red, grn, and blu represent 4-bit red, green, and blue intensity va¬ 
lues, respectively. The rightmost field contains the color-repeat attribute 
bit. The attribute field is typically set to 0. Refer to the TMS34070 Color 
Palette User's Guide for a description of the color repeat attribute bit. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


static short palet[16] = { /* gray scale */ 

0x0000, 0x1110, 0x2220, 0x3330, 

0x4440, 0x5550, 0x6660, 0x7770, 

0x8880, 0x9990, OxAAAO, OxBBBO, 

OxCCCO, OxDDDO, OxEEEO, OxFFFO 

}; 

long pixval, x; 

init—video(1) ; 

init—grafix() ; 

pixval = 0x77777777; /* 4 bits/pixel */ 

new—screen(pixval, palet); 

for (x = 13, pixval = 0; x < 620; x += 39) { 
set—color1(pixval); 
fill-rect(29, 460, x, 10); 
set—colorl(O); 
draw—rect ( 30 , 461, x-*l, 9); 
pixval += 0x11111111; 

} 
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open—vuport 


Open Viewport Function 


Syntax 

Description 


Example 


int open—vuport() 

The open—vuport function opens a new viewport and returns an index that 
identifies the viewport in subsequent transactions. The new viewport au¬ 
tomatically becomes the active viewport for subsequent drawing oper¬ 
ations. The new viewport inherits the attributes of the viewport that was 
active at the time the call was initiated. 

The new viewport automatically Inherits the viewport attributes of the pre¬ 
vious active viewport (that is, the viewport that was active just prior to the 
call to the open—vuport function). The inherited attributes Include: 

• Viewport size and position 

• XY coordinate origin 

• Clipping rectangle 

• Font 

• COLORO and COLOR1 

• Pixel processing operation 

• Plane mask 

• Transparency attribute (on or off) 

• Drawing pen width and height 

• 16x16 pattern 

• Incremental text spacing parameter (see add—text—space function) 

If the maximum number of viewports are already opened at the time of the 
call, a value of -1 is returned in place of a valid viewport Index. 


Note: 

Before you call the open—vuport function, call the init—vuport function 
to Initialize the viewport data structures. 


#include "colors.h" 
int vindex; 


init—video(1) 
init—grafix() 
init—vuport(); /* 

init—screen() 
set—colorO(BLUE); /* 

vindex = open—vuport();/* Open vuport 1 
y-k-k* Viewport 1 inherits colorO from viewport 0 
set—color1(GRAY); /* Viewport I's colorl = GRAY 

y-k-k-k Fill square with blue-and-gray pattern 

patnfill-rect(96, 96, 272, 192); 


Open vuport 0 

Viewport O's colorO = BLUE 


V 

V 

■k*-ky 

V 

-k-k-k y 
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Pattern Fill Convex Polygon Function 


patnfill—convex 


Syntax 


Description 


int patnfill_convex(n, edgelist, ptlist) 

int n; /* number of polygon vertices */ 

short edgelist[]; /* list of edges */ 

short ptlist[]; /* list of vertices (points) */ 

The patnfill—convex function fills a convex polygon with a pattern given a 
list of points representing the vertices. In order to be drawn correctly, the 
polygon must be convex; that Is, it should contain no concavities. A poly¬ 
gon must have at least three vertices to be visible. An edge of the polygon 
is assumed between the first and last vertices specified. The polygon is 
pattern-filled with the current pattern, which is drawn in colors COLORO 
andCOLORI. 

The function requires three input arguments: 

• Argument n defines the number of vertices In the polygon. 

• The second argument, edgelist, is an array of type short. The 
members of the array are indices that specify the order in which the 
vertices are traversed, moving in a clockwise direction around the 
edge of the polygon. {Clockwise, In this context, assumes X increas¬ 
ing from left to right and Y increasing from top to bottom.) Each el¬ 
ement of the edgelist array is an index into the ptlist array. 

• The third argument, ptlist. Is an array of type short. Each pair of 
adjacent 16-bit elements contains the X and Y coordinates, respec¬ 
tively, of a vertex. 

For example, edgelist [k] contains the Index for vertex k, where k is in the 
range 0 to n-1. The X and Y coordinates for vertex k are contained in 
ptlist[2*n] and ptlist[2*n+1 ]. 

The patnfill—convex function does automatic culling of back faces to sup¬ 
port 3D applications. In other words, a polygon is drawn only if Its front 
side is visible; that Is, if it is facing toward the screen. If the vertices are 
supplied in counterclockwise order, the polygon is assumed to be facing 
away from the screen and is therefore not drawn. In this case, a value of 0 
is returned by the function. Otherwise, a value of 1 is returned to Indicate 
that the polygon is visible. 

The back face test is done by first comparing vertices n-2, n-1, and 0 to 
determine whether the polygon vertices are specified in clockwise (front 
face) or counterclockwise (back face) order. This test relies on the polygon 
containing no concavities. If the three vertices are found to be colinear, the 
back face test is made again using the next three vertices, n-1 ,0 and 1 . The 
test repeats until three vertices are found that are not colinear. If all the 
vertices are colinear, the polygon is Invisible and a value of 0 Is returned. 

This function is similar to the patnfill—polygon routine, but is specialized for 
rapid drawing of convex polygons. Note that the edgelist array format 
for the patnfill—convex function differs from the linelist array format for 
the patnfill—polygon function. While the patnfill—convex function Is more 
specialized than the patnfill—polygon function, it also executes more rap¬ 
idly. 
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patnfill—convex 


Pattern Fill Convex Polygon Function 



Example long i, hue, patn; 

static short connect[] = C 0, 1, 2 }; 

static short xy[] = { 0,-170, 196,170, -196,170 }; 

init—video(1); 
init—grafix(); 
init—vuport() ; 
set—origin(320, 240); 
init—screen(); 

for (i = 15, hue = patn =0; i > 0; --i) { 

set—color0(hue += 0x11111111); 
set—color 1 ( ~hue) ; 
select—patn(patn++); 
patnfill—convex(3, connect, xy); 
xy[0] += xy[l] » 3; 

xy[l] -= xy[0] >> 3; 

xy[2] += xy[3] >> 3; 

xy[3] -= xy[2] » 3; 

xy[4] += xy[5] >> 3; 

xy[5] -= xy[4] >> 3; 

} 
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Pattern Fill Oval Function 


patnfill—oval 


Syntax 


Description 


Example 


void patnfill—oval(w, h, xleft, ytop) 

int w, h; /* width and height of enclosing */ 

/* rectangle */ 

int xleft, ytop; /* XY coordinates of top left */ 

/* corner */ 

The patnfill—oval function fills an ellipse with a pattern. The ellipse is in 
standard position, with its major and minor axes parallel to the coordinate 
axes. The ellipse is filled with the current pattern In colors COLORO and 
C0L0R1. 

The ellipse is defined by the minimum enclosing rectangle in which It is 
Inscribed. Four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xlef t,ytop). 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, hue, patn; 

init—video(1); 
init—grafix(); 
init—screen(); 

/*** Pattern fill ellipses of various sizes ***/ 

X = y = hue = patn = 0; 

for (w = 640, h = 480; w >= 192; w -= 32, h -= 24) { 

set—colorO(hue += 0x11111111); /* pixel = 4 bits */ 

Set—color 1 (hue) ; 
select—patn(patn++); 
patnfill—oval(w, h, x, y) ; 

} 
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patnfill—piearc 


Pattern Fill Pie Arc Function 


Syntax 


Description 


void patnfill—piearc(w, 
int w, h, /* 

int xleft, ytop; /* 
int theta; /* 

int arc; /* 


h, xleft, ytop, theta, arc) 
width and height */ 

top left corner */ 

starting angle (degrees) */ 

extent of angle (degrees) */ 


The patnfill—piearc function fills a pie-shaped wedge with a pattern. The 
wedge is bounded by an arc and two straight edges. The arc is taken from 
an ellipse in standard position, with its major and minor axes parallel to the 
coordinate axes. The two straight edges are defined by lines connecting the 
end points of the arc with the center of the ellipse. The arc is filled with the 
current pattern in colors COLORO and C0L0R1. 

The ellipse from which the arc is taken is specified in terms of the minimum 
enclosing rectangle In which It is inscribed. The first four arguments define 
the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta. Is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Posi¬ 
tive angles are in the clockwise direction, negative angles are coun¬ 
terclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or ne¬ 
gative) spanned by the angle. If the arc extent is outside the range 
[-359,+359], the entire ellipse Is drawn. 

Both arguments are expressed In degrees of elliptical arc, with 360 degrees 
representing one full rotation. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 
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Pattern Fill Pie Arc Function 


patnfill—piearc 


Example 


/****************************/ 

/* Draw a pie chart */ 

/****************************/ 

static int tarc[] = { 50, 40, 35, 100, 80, 55 }; 
long i, w, h, x, y, tstart, patn; 

long hue = OxEEEEEEEE; /* Assume 4 bits/pixel */ 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 480; 

h = 360; 

X =50; 

y =60; 

tstart = 25; 
patn = 0; 

for (i = 0; i <= 5; ++i) C 

set—color1(hue -= 0x11111111); 
set—colorO ( ^hue) ; 
select—patn(t+patn); 
if (i == 5) 

X += w/8; 

patnfill—piearc(w, h, x, y, tstart, tarc[i]); 
tstart += tarc[i]; 

} 
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patnf ill—polygon 


Pattern Fill Polygon Function 


Syntax 


Description 


void patnfill-polygon(n, linelist, ptlist) 

int n; /* number of edges */ 
short linelist[]; /* list of edges */ 
short ptlist[]; /* list of vertex coordinates */ 


The patnfill—polygon function fills a polygon with a pattern given a list of 
lines representing the edges of the polygon. No restrictions are placed on 
the shape of the polygons filled by the function: edges can cross each other, 
filled areas can contain holes, and two or more filled regions can be dis¬ 
connected from each other. The polygon is filled with the current pattern 
in colors COLORO and COLOR1. 

The function requires three input arguments: 


• Argument n defines the number of vertices in the polygon. 

• The second argument, linelist, is an array of type short. Each pair 
of array elements defines an edge: the first of the two elements defines 
the starting vertex of the edge, and the second defines the ending 
vertex. Each element of the linelist array is an Index into the 
ptlist array. 

• The third argument, ptlist, is an array of type short. Each pair of 
adjacent 16-bit elements contains the X and Y coordinates, respec¬ 
tively, of a vertex. 


Each pair of adjacent 16-blt elements in the ptlist array is an X coordinate 
followed by a Y coordinate. Each pair of adjacent 16-bit elements in the 
linelist array is a pair of indices into the ptlist array. 


For example, the first edge drawn is specified in array elements, 
linelist[0] and linelist[1]. Assume that these contain index values 
4 and 7, respectively. The starting coordinates for the line defining the edge 
are contained in ptlist[2*4] and ptlist[2*4 + 1 ]. The ending coordi¬ 
nates are contained in ptlist[2*7] and ptlist[2*7 + 1 ]. 


The Individual elements of the linelist array are assigned as follows: 


linelist [0] 
linelist [1 ] 
linelist[2] 
linelist[3] 


= starting vertex for edge 0 
= ending vertex for edge 0 
= starting vertex for edge 1 
= ending vertex for edge 1 


linelist[2n] = starting vertex for edge n-1 
linelist [2n+1 ] = ending vertex for edge n-1 
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Pattern Fill Polygon Function 


patnf ill—polygon 


Example 


The individual elements for the ptlist array are assigned as follows: 


ptlist[0] 
ptlist [1 ] 
ptlist[2] 
ptlist[3] 


= X coordinate value for point 0 
= y coordinate value for point 0 
= X coordinate value for point 1 
= y coordinate value for point 1 


ptlist[2m] = X coordinate value for point m-1 
ptlist[2mt1] = y coordinate value for point m-1 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


static short xy[] = { 

193,60, 460,60, 377,440, 524,423, 

15,233, 570,100, 98,382 

} ; 

static short shape[] = { 

0,1, 1,2, 2,3, 3,0, 4,5, 5,6, 6,4 

}; 

init—video(1); 
init—grafix(); 
init—screen(); 

set—colorO(0x44444444); /* pixel = 4 bits */ 
set-colorl(0x77777777); 
select—patn(4); 

patnfill—polygon(7, shape, xy); 
for (;;) ; 
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patnfill—rect 


Pattern Fill Rectangle Function 


Syntax 


Description 


Example 


void patnfill—rect(w, h, xleft, ytop) 

int w, h; /* width and height of rectangle */ 

int xleft, ytop; /* XY coord at top left corner */ 

The patnfill—rect function fills a rectangle with a pattern. The rectangle Is 
filled with the current pattern in colors COLORO and C0L0R1. Four ar¬ 
guments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft^ytop). 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


init—video (1) ; 
init—graf ix () ; 
init—screen() ; 

set—color1(0x11111111); /* Assume 4 bits/pixel */ 
select—patn(8); 

patnfill—rect (440, 280, 100, 100); 
set—colorO(0x44444444); 
set-colorl(0x77777777) ; 
select—patn(4); 

patnfill—rect(420, 30, 110, 110); 
patnfill-rect(220, 220, 110, 150); 
patnfill—rect(190, 150, 340, 150); 
patnfill-rect(190, 60, 340, 310); 
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Pattern Frame Oval Function 


patnframe—oval 


Syntax 


Description 


Exampie 


void patnframe—oval(w, h, xleft, ytop, dx, dy) 

int w, h; /* width and height of enclosing */ 

/* rectangle */ 

int xleft, ytop; /* coordinates at top left corner */ 

int dx, dy; /* width and height of frame border*/ 

The patnframe—oval function fills an ellipse-shaped frame with a pattern. 
The frame consists of a filled region between two concentric ellipses. The 
frame is filled with the current pattern in colors COLORO and C0L0R1. 
The portion of the screen enclosed by the frame is not altered. 

The outer ellipse is specified in terms of the minimum enclosing rectangle 
in which it is inscribed. The first four arguments define the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The thickness of the frame in the X and Y dimensions is defined by two 
additional arguments, dx and dy, which specify the horizontal and vertical 
distances, respectively, between the outer and inner ellipses. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, dx, dy; 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 480; 
h = 360; 

X =80; 
y =60; 
dx = 40; 
dy = 30; 

set—colorO(0x11111111) ; 
set-colorl(0x77777777) ; 
select—patn(7); 

patnframe—oval (w, h, x, y, dx, dy); 
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patnframe—rect 


Pattern Frame Rectangle Function 


Syntax 


Description 


Exampie 


void patnframe—rect(w, h, xleft, ytop, dx, dy) 

int w, h; /* width and height of enclosing */ 

/* rectangle */ 

int xleft, ytop; /* coordinates at top left corner */ 

int dx, dy; /* width and height of frame border*/ 

The patnframe—rect function fills a rectangular frame with a pattern. The 
frame consists of a filled region between two concentric rectangles. The 
frame Is filled with the current pattern In colors COLORO and COLOR!. 
The portion of the screen enclosed by inner edge of the frame is not altered. 

The first four arguments define the outer rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The thickness of the frame in the X and Y dimensions Is defined by two 
additional arguments, dx and dy, which specify the horizontal and vertical 
distances, respectively, between the outer and inner rectangles. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, dx, dy; 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 480; 
h = 360; 

X = 80; 
y =60; 
dx = 40; 
dy = 30; 

set—colorO(0x11111111) ; 
set-colorl(0x77777777) ; 
select—patn(7); 

patnframe—rect(w, h, x, y, dx, dy); 
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Pattern Pen Line Function 


patnpen—line 


Syntax 


Description 


Example 


void patnpen—line(xl, yl, x2, y2) 

int xl, yl; /* starting coordinates */ 

int x2, y2; /* ending coordinates */ 

The patnpen—line function uses the pen to draw a patterned line. Argu¬ 
ments xl and yl specify the starting coordinates of the line, and x2 and 
y2 specify the ending coordinates. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the line drawn by the 
patnpen—line function, the pen is located such that Its top left corner 
touches the line. The area covered by the pen Is filled with the current 
pattern in colors COLORO and COLOR1. 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


long X, y, patn, hue; 

init—video(1); 
init—grafix(); 
init—screen(); 
set—pensize(20, 16); 
patn = hue = 0; 

for (x = 8, y = 455; x < 631; x += 43) { 
setJcolorO ( ~hue) ; 

set—color1(hue += 0x11111111); /* pixel = 4 bits */ 
select—patn(patn++); 
patnpen—line(8, 8, x, y); 
patnpen—line(610, 8, x, y); 

} 




patnpen—ovalarc 


Syntax 


Description 


Pattern Pen Oval Arc Function 


void patnpen—ovalarc(w, h, xleft, ytop, theta, arc) 
int w, h, /* width and height */ 

int xleft, ytop; /* top left corner */ 

int theta; /* starting angle (degrees) */ 

int arc; /* angle extent (degrees) */ 

The patnpen—ovalarc function uses the pen to draw a patterned arc of an 
ellipse. The ellipse is in standard position, with the major and minor axes 
parallel to the coordinate axes. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the arc drawn by the 
patnpen—line function, the pen is positioned such that its top left corner 
touches the arc. The area covered by the pen is filled with the current pat¬ 
tern in colors COLORO and COLOR1. 

The ellipse from which the arc is taken is specified in terms of the minimum 
enclosing rectangle in which it is inscribed. The first four arguments define 
the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta, is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Posi¬ 
tive angles are in the clockwise direction, negative angles are coun¬ 
terclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or ne¬ 
gative) spanned by the angle. If the arc extent is outside the range 
[-359,+359], the entire ellipse is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 degrees 
representing one full rotation. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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patnpen—ovalarc 


Pattern Pen Oval Arc Function 


Example int w, h, x, y, t St art, tare; 

long hue, patn; 

init—video(1); 
init—grafix{); 
init—screen(); 
set—pensize(32, 24); 

X = 320; 
y = 240; 
w = h = 0; 
tare =35; 

for (tstart = 0; tstart < 1500; tstart += 30) { 
set—colorO ( ^hue) ; 
if ((hue -= 0x11111111) == 0) 
hue = OxFFFFFFFF; 
set—color1(hue); 
if (++patn >= get—patn—max()) 
patn = 0; 

select—patn(patn); 

patnpen—ovalarc(w, h, x, y, tstart, tare); 

w += .16; 
h += 12; 

X -= 8; 

y -= 6; 

} 
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patnpen—piearc 


Pattern Pen Pie Arc Function 


Syntax 


Description 


void patnpen—piearc(w, h. 


int w, h, /* 
int xleft, ytop; /* 
int theta; /* 
int arc; /* 


xleft, ytop, theta, arc) 
width and height */ 

top left corner */ 

starting angle (degrees) */ 

angle extent (degrees) */ 


The patnpen—piearc function uses the pen to draw a patterned, pie-shaped 
wedge from an ellipse. The wedge is formed by an arc of the ellipse, and 
by two straight lines that connect the two end points of the arc with the 
center of the ellipse. The ellipse is in standard position, with the major and 
minor axes parallel to the coordinate axes. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the arc drawn by the 
patnpen—line function, the pen is positioned such that its top left corner 
touches the arc. The two lines from the center are drawn in similar fashion. 
The area covered by the pen is filled with the current pattern in colors 
COLORO and COLOR1. 

The ellipse from which the arc is taken is specified in terms of the minimum 
enclosing rectangle In which it is inscribed. The first four arguments define 
the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta. Is measured from the center of the right 
side of the enclosing rectangle, and Is treated as modulus 360. Posi¬ 
tive angles are in the clockwise direction, negative angles are coun¬ 
terclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or ne¬ 
gative) spanned by the angle. If the arc extent is outside the range 
[-359,+ 359], the entire ellipse is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 degrees 
representing one full rotation. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 
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Pattern Pen Pie Arc Function 


patnpen—piearc 


Example static t[] = { 

110,100, 30,80, 15,15, 210,90, 300,30, 330,45 

}; 

long i, w, h, x, y, patn, hue; 

init—video(1); 
init—grafix(); 
init_screen(); 
w = 280; 
h = 440; 

X = 105; 
y = 20; 
patn = 16; 

set—pensize(80, 1); /* long, skinny pen */ 
for (i = hue =0; i <= 5; ++i) { 
if (i == 5) 

X += w/4; 

select—patn(patn++); 
set—colorO ( ~hue) ; 

set—color1(hue += 0x11111111); /* 4-bit pixel */ 
patnpen—piearc(w, h, x, y, t[2*i], t[2*i+l]); 

} 

for (i = hue =0, x -= w/4; i <= 5; ++i) { 

if (i == 5) 

X += w/4; 

set—color1(hue += 0x11111111); 

fill—piearc(w, h, x, y, t[2*ii, t[2*i+l]); 

} 
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patnpen—point 


Pattern Pen Point Function 


Syntax 

Description 


Example 


void patnpen—point(x, y) 

int X, y; /* pen coordinates */ 

The patnpen—point function uses the pen to draw a patterned point The 
resulting figure is a rectangle the width and height of the pen, and filled 
with the current pattern In colors COLORO and COLOR1. The top left 
corner of the rectangle Is located at coordinates (x, y). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment 


int i, w, h, X, y, patn; 

long hue; /* Assume 4 bits/pixel */ 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 12; 
h = 9; 

x = 16 << 16; 
y = 12 << 16; 
patn = 0; 
hue = OxFFFFFFFF; 
for (i = 100; i > 0; —i) { 
set—colorO ('^hue) ; 
if ((hue -= 0x11111111) == 0) 
hue = OxFFFFFFFF; 
set—color1(hue); 
set—pensize (++W, ++h); 
if (++patn == get—patn—max()) 
patn = 0; 

select—patn(patn); 

patnpen—point((x>>16)+350, (y>>16)+200); 

X += y >> 3; 
y -= X >> 3; 

X += X >> 5; 

y += y >> 5; 

} 
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Pattern Pen Polyline Function 


patnpen—polyline 


Syntax 


Description 


void patnpen—polyline(n, linelist, ptlist) 

int n; /* number of lines */ 
short linelist[]; /* list of lines */ 
short ptlist[]; /* list of points */ 


The patnpen—polyline function uses the pen to draw multiple patterned 
lines. 

• n specifies the number of lines that are drawn. 

• linelist is an array of type short; it specifies the list of lines that are 
drawn. Each element in the linelist array is an index into the 
ptlist array. 

• The third argument, the ptlist array, contains the XY coordinates 
of the starting and ending points for each line. 

Each pair of adjacent 16-bit elements In the ptlist array Is an X coordinate 
followed by a Y coordinate. Each pair of adjacent 16-blt elements in the 
linelist array is a pair of indices Into the ptlist array, all the line 
starting and ending points. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on a line drawn by the 
patnpen—line function, the pen Is located such that its top left corner 
touches the line. The area covered by the pen Is filled with the current 
pattern in colors COLORO and COLOR1. 

The individual elements of the linelist array are assigned as follows: 

linelist [0] = starting point of line 0 

linelist[1] = ending point of line 0 
linelist [2] = starting point of line 1 

linelist[3] = ending point of line 1 


linelist[2n] = starting point of line n-1 
linelist[2n+1] = ending point of line n-1 

The individual elements of the ptlist array are assigned as follows; 


ptlist[0] 
ptlist [1 ] 
ptlist[2] 
ptlist [3] 


= X coordinate value for point 0 
= y coordinate value for point 0 
= X coordinate value for point 1 
= y coordinate value for point 1 


ptlist[2m] = X coordinate value for point m-1 
ptlist[2m + 1] = y coordinate value for point m-1 


For example, the first line drawn is specified in the first two elements, li¬ 
nelist [0] and linelist[1]. Assume that these contain index values 4 
and 7, respectively. The starting coordinates for the line are contained in 
ptlist [2*4] and ptlist[2*4+1]. The ending coordinates are contained 
in ptlist[2*7] and ptlist[2*7 + 1 ]. 
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patnpen—polyline 


Pattern Pen Polyline Function 


Example 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


static short xy[] = { 

380,200, 480,200, 480,300, 380,300, 

340,270, 340,170, 440,170, 

230,180, 280,300, 160,300, 146,263 

} ; 

static short cube[] = { 

0,1, 1,2, 2,3, 3,4, 4,5, 5,6, 6,1, 3,0, 5,0, 

} ; 

static short pyramid[] = { 

7,8, 8,9, 9,10, 10,7, 7,9 

}; 

/*** Draw a cube and a pyramid sitting side by side ***/ 

init—video(1); 

init—grafix(); 

init—screen(); 

set—pensize(9, 8); 

select—patn(21) ; 

patnpen—polyline(9, cube, xy); 

set—colorO(0x11111111); /* 4-bit pixel */ 

set-colorl(0x33333333); 

set—pensize(7, 6); 

select—patn(15) ; 

patnpen—polyline(5, pyramid, xy); 
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Peek Function 


peek 


Syntax 

Description 

Example 


int peek(address) 

long address; /* 32-bit memory address */ 

The peek function returns the contents of a memory location. The value of 
the memory word is returned in the 16 LSBs of the 32-bit return value. The 
16 MSBs are Os. 


#define VCLK 160 /* video clock period (ns) */ 

#define HTOTAL 0xC0000030 
#define VTOTAL 0xC0000070 
int tick; 

init—video(1); 

/*** Calculate frame duration in ns ***/ 

tick = (peek(HTOTAL) + 1) * (peek(VTOTAL) + 1) * VCLK; 




peek—breg 


Peek B Register Function 


Syntax 

Description 

Example 


long peek—breg(breg) 

int breg; /* B-file register number */ 

The peek—breg function returns the contents of a B-file register. Argument 
breg is a register number in the range 0 to 15. The function ignores ail but 
the 4 LSBs of breg. The return value is 32 bits. 

#define DPTCH 3 /* B3 register */ 

long dest—pitch; 

init—video(1); 

/*** Read screen pitch ***/ 
dest—pitch = peek—breg(3); 
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Pen Line Function 


pen—line 


Syntax 


Description 


Example 


void pen-line(xl, yl, x2, y2) 

int xl, yl; /* starting coordinates */ 

int x2, y2; /* ending coordinates */ 

The pen—line function uses the pen to draw a line. Arguments xl and yl 
specify the starting coordinates of the line, and x2 and y2 specify the end¬ 
ing coordinates. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the line drawn by the 
pen—line function, the pen is located such that its top left corner touches 
the line. The area covered by the pen is solid-filled in the current COLOR1. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


long color; /* Assume 4 bits/pixel */ 

int xl, yl, x2, y2; 

init—video(1); 
init—grafix(); 

patnfill—rect(640, 480, 0, 0); 

init—palet(); 

set—pensize{20, 16); 

color = 0; 

xl = yl = 8; 

for (x2 = 8, y2 = 455; x2 < 631; x2 += 43) { 

set—color1(color += 0x11111111); 
pen—line(xl, yl, x2, y2); 

} 
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pen—ovalarc 


Pen Oval Arc Function 


Syntax 


Description 


void pen—ovalarc(w, 
int w, h, 
int xleft, ytop; 
int theta; 
int arc; 


h, xleft, ytop, theta, arc) 

/* width and height 
/* top left corner 
/* starting angle (degrees) 
/* angle extent (degrees) 


V 

*/ 

V 

V 


The pen—ovalarc function uses the pen to draw an arc taken from an ellipse. 
The ellipse is in standard position, with the major and minor axes parallel 
to the coordinate axes. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the arc drawn by the 
pen—line function, the pen is located such that its top left corner touches 
the arc. The area covered by the pen is solid-filled in the current C0L0R1. 

The ellipse from which the arc is taken is specified in terms of the minimum 
enclosing rectangle in which it is inscribed. The first four arguments define 
the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments define the limits of the arc; 

• The starting angle, theta, is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Posi¬ 
tive angles are in the clockwise direction, negative angles are coun¬ 
terclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or ne¬ 
gative) spanned by the angle. If the arc extent is outside the range 
[-359,+359], the entire ellipse is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 degrees 
representing one full rotation. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 
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Pen Oval Arc Function 


pen—ova la rc 


Example 


int w, h, X, y, tstart, tare; 

init—video(1); 
init—grafix(); 
init—screen(); 
set—pensize(4, 3); 

X = 320; 

Y = 240; 
w = h = 0; 
tare = 35; 

for (tstart = 0; tstart < 1500; tstart += 30) { 
pen—ovalarc(w, h, x, y, tstart, tare); 
w += 16; 
h += 12; 

X -= 8; 

y -= 6; 
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pen—piearc 


Pen Pie Arc Function 


Syntax 


Description 


void pen—piearc(w, h, xleft, ytop, theta, arc) 

int w, h, /* width and height */ 

int xleft, ytop; /* top left corner */ 

int theta; /* starting angle (degrees) */ 

int arc; /* angle extent (degrees) */ 

The pen—piearc function uses the pen to draw a pie-shaped wedge from 
an ellipse. The wedge is formed by an arc of the ellipse, and by two straight 
lines that connect the two end points of the arc with the center of the el¬ 
lipse. The ellipse is in standard position, with the major and minor axes 
parallel to the coordinate axes. 

The pen Is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on the arc drawn by the 
pen—line function, the pen is located such that its top left corner touches 
the arc. The two lines are drawn in similar fashion. The area covered by the 
pen is solid-filled in the current COLOR1. 

The ellipse from which the arc is taken Is specified in terms of the minimum 
enclosing rectangle in which it is inscribed. The first four arguments define 
the rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xlef t,ytop). 

The last two arguments define the limits of the arc: 

• The starting angle, theta, is measured from the center of the right 
side of the enclosing rectangle, and is treated as modulus 360. Posi¬ 
tive angles are in the clockwise direction, negative angles are coun¬ 
terclockwise. 

• The arc extent, arc, specifies the number of degrees (positive or ne¬ 
gative) spanned by the angle. If the arc extent is outside the range 
[-359,+359], the entire ellipse is drawn. 

Both arguments are expressed in degrees of elliptical arc, with 360 degrees 
representing one full rotation. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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Pen Pie Arc Function 


pen—piearc 


Example 


int w, h, X, y, t, dt, dx; 

init—video(1); 
init—grafix(); 
t = dx = dt = 8; 
w = h = 80; 

for (x = -w, y = 350; x < 640; x += dx) C 
if ( (t += dt) >80 II t <= 0) 
dt = -dt; 
delay(0); 
init—screen(); 

pen—piearc(w, h, x, y, t/2, 360-t); 
pen—piearc(w, h, x+w/2, y, -15, 30); 
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pen—^point 


Pen Point Function 


Syntax 

Description 


Example 


void pen—point(x, y) 

int X, y; /* pen coordinates */ 

The pen—point function uses the pen to draw a point The resulting figure 
is a rectangle the width and height of the pen, and solid-filled with the 
current COLOR1. The top left corner of the rectangle is located at coordi¬ 
nates (x, y). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment 


int i, W/ h, X, y; 

long c; /* Assume 4 bits/pixel */ 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 12; 
h = 9; 

X = 16 << 16; 
y = 12 << 16; 

C = OxFFFFFFFF; 

for (i = 100; i > 0; —i) { 

if ((c “= 0x11111111) == 0) 
c = OxFFFFFFFF; 
set—color1(c); 
set—pensize (++W, ++h); 
pen—point((x>>16)+350, (y>>16)+200); 


+= 

y 

>> 

3 

- = 

X 

>> 

3 

+= 

X 

>> 

5 

+= 

y 

>> 

5 


} 
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Pen Polyline Function 


pen—polyline 


Syntax void pen_polyline(n, linelist, ptlist) 

int n; /* number of lines */ 

short linelist[]; /* list of lines */ 

short ptlist[]; /* list of points */ 

Description The pen—polyline function uses the pen to draw multiple lines. 

• n specifies the number of lines that are drawn. 

• linelist is an array of type short; it specifies the list of lines that are 
drawn. Each element in the linelist array is an index into the 
ptlist array. 

• The third argument the ptlist array, contains the XY coordinates 
of the starting and ending points for each line. 

Each pair of adjacent 1 6-bit elements in the ptlist array is an X coordinate 
followed by a Y coordinate. Each pair of adjacent 16-bit elements in the 
linelist array is a pair of indices into the ptlist array. 

The pen is a rectangle whose width and height can be modified by means 
of the set—pensize function. At each point on a line drawn by the 
pen—line function, the pen is located such that its top left corner touches 
the line. The area covered by the pen is solid-filled In the current COLOR1. 

For example, the first line drawn is specified In the first two elements, li- 
nelist[0] and linelist[1]. Assume that these contain index values 4 
and 7, respectively. The starting coordinates for the line are contained in 
ptlist[2*4] and ptlist[2*4+1 ]. The ending coordinates are contained 
In ptlist[2*7] and ptlist[2*7 + 1 ]. 

The individual elements of the linelist array are assigned as follows: 

linelist[0] = starting point of line 0 

linelistfl] = ending point of line 0 

linelist[2] = starting point of line 1 

linelist[3] = ending point of line 1 


linelist[2n] = starting point of line n-1 
linelist[2n + 1] = ending point of line n-1 

The individual elements of the ptlist array are assigned as follows: 

ptlist[0] = X coordinate value for point 0 

ptlist[1 ] = y coordinate value for point 0 

ptlist[2] = X coordinate value for point 1 

ptlist[3] = y coordinate value for point 1 


ptlist[2m] = X coordinate value for point m-1 
ptlist[2m+1 ] = y coordinate value for point m-1 


5-129 




pen—polyline 


Example 


Pen Polyline Function 


Note: 

Before you cal! this function, call the init—grafix function to initialize the 
graphics environment. 


static short xy[] = { 

380,200, 480,200, 480,300, 380,300, 

340,270, 340,170, 440,170, 

230,180, 280,300, 160,300, 146,263 

} ; 

static short cube[] = { 

0,1, 1,2, 2,3, 3,4, 4,5, 5,6, 6,1, 3,0, 5,0, 

} ; 

static short pyramid[] = { 

7,8, 8,9, 9,10, 10,7, 7,9 

}; 

/**************************************************/ 
/* Draw a cube and a pyramid sitting side by side */ 

/**************************************************/ 

init—video(1); 

init—grafix(); 

init—screen(); 

set—pensize(5, 5); 

pen—polyline(9, cube, xy); 

set—color1(0x11111111); /* Assume 4 bits/pixel */ 

set—pensize(7, 7); 

pen—polyline(5, pyramid, xy); 
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Perspective Function 


perspec 


Syntax 


Description 


void perspec(n, vertlist, ptlist. 


typedef long FIX; /* 
int n; /* 
FIX vertlist[]; /* 
short ptlist[]; /* 


int xview, yview, zview; /* 


xview, yview, zview) 

32-bit fixed-point format */ 
number of vertices in list */ 
list of 3D vertices in xyz */ 
list of 2D points in xy */ 
viewer's xyz coordinates */ 


The perspec function performs perspective transformations on an input list 
of 3D vertices, mapping them to an output list of 2D points. 

• The first argument, n, specifies the number of vertices that are trans¬ 
formed. 

• The second argument, vertlist, is a list of three-dimensional ver¬ 
tices. Each vertex in the list is represented as a 96-bit quantity con¬ 
sisting of three 32-bit X, Y, and Z fixed-point coordinate values. The 
fixed-point format assumes that the 16 LSBs lie to the right of the 
binary point. 

• The third argument, ptlist, is a list of two-dimensional points. Each 
point in the list Is represented as a 32-blt quantity consisting to two 
16-blt X and Y coordinate values. 

• The last three arguments, xview, yview, and zview, are the coordi¬ 
nates of the viewer's position. 

The positive Z direction is into the screen. The face of the screen is at Z=0. 
The viewer's position Is typically in negative Z space. If a vertex to be 
transformed is at the same Z value as the viewer or behind (that is, more 
negative Z) the viewer, the results are unpredictable. 

The perspec function scales the X and Y displacements of each three- 
dimensional point. The displacements are measured from the viewer's X 
and Y coordinates, and are scaled in inverse proportion to the point's dis¬ 
tance In Z from the viewer. The X and Y displacements become smaller as 
the distance from the viewer increases. The result Is a two-dimensional 
array of points representing 3D objects which are scaled in accordance to 
their distance from the viewer. Please refer to Principles of Interactive 
Graphics (Newman and Sproull) for more information on perspective tran¬ 
sformations. 

The figure on the next page shows the perspective scaling of a point In 
three-dimensional space. For simplicity, only the scaling of the Y coordi¬ 
nate is shown. The face of the screen is at Z = 0, and Is in the plane con¬ 
taining the X and Y axes. The perspective calculations are performed 
assuming the viewer is at coordinates (Xview'^view^Zview)' where Zyiew ‘s 
negative. The 3D point is located behind the screen at coordinates 
(ZobjectA^object'^object)^ where Z is positive. The projection of the 3D point 
on the face of the screen is obtained by simple linear interpolation: 

(Y - Y ) X (Z - Y ) 

^screen object view screen view x Y view 

^object ■ ^view 
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perspec 


Perspective Functiich 


where; 

^screen projection of 3D point on screen 
Yview/Zview viewer's Y and Z coordinates 
Yobject^Zobject = 3D point's Y and Z coordinates 

The value Ygcreen is the scaled version of Yobject returned by the perspec 
function. An Xscreen value is calculated In similar fashion. 
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Perspective Function 


perspec 


Example 


typedef long FIX; 
static FIX rotation[3] 
{ 


static long xyz[] 

-60,-60,-60, 60,-60,-60, 
60, 60,-60, -60, 60,-60, 
-60,-60, 60, 60,-60, 60, 
60, 60, 60, -60, 60, 60 

}; 

static short faces[6][4] = { 


{ 0 , 0 , 


c 

0, 

Ir 

2, 

3 

}, 

{ 

7, 

6, 

5, 

4 

3, 

{ 

4, 

5, 

Ir 

0 

}, 

{ 

5, 

6, 

2, 

1 

3, 

{ 

6, 

7, 

3, 

2 

3, 

{ 

4r 

0, 

3, 

7 

3 


}; 

FIX matrix[16], verts[24]; 
short xy[16] ; 
long i, c, angle; 


0 


} ; 


init—video(1) ; 
init—grafix(); 
init—vuport(); 

set—origin(320, 240); /* center origin */ 
for (;;) 

for (angle = 0; angle < 360; angle += 4) { 

init—matrix(matrix); 
rotation[2] = angle << 16; 
rotate(matrix, rotation); 
long—to—fix(24, xyz, verts) ; 
transform(matrix, 8, verts); 
perspec(8, verts, xy, 0, -80, -200); 
delay(0); 
init—screen(); 

for (i = c = 0; i <= 5; ++i) { 

set—colorl(c += 0x11111111); /*pixel=4 bits*/ 
fill—convex(4, faces[i], xy); 

} 

} 
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poke 


Poke Function 


Syntax 

Description 

Example 


void poke(address, value) 

long address; /* 32-bit memory address */ 

int value; /* value to be poked */ 

The poke function stores the 16 LSBs of value at location address. 

init—video (1) ; 

y**************************/ 

/* Change pixel size to 1 */ 

y**************************y 
poke(0xC0000150, 1); 
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Poke B Register Function 


poke—breg 


Syntax 

Description 

Example 


void poke-JDreg(breg, value) 

long breg; /* B-file register number */ 

int value; /* 32-bit register contents */ 

The poke—breg function stores the 32-bit value in a B-file register. Argu¬ 
ment breg is a register number from 0 to 1 5. 

init—video{1); 

/**************************/ 

/* Change OFFSET register */ 

poke—breg(4, 512*4); 
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pow 


Raise to a Power Function 


Syntax 

Description 


Example 


double pow(x, y) 

double X, y; /* Raise x to power y */ 

The pow function calculates x raised to the power y (x^). The two argu¬ 
ments and the return value are all double-precision floating-point values. 

The value returned is 0 if both x and y are 0. 

Several error conditions are detected: 

• If X < 0, the return value is (-x)^ and the _fp—error function Is called 
with an error code of 24. 

• If X = 0 and y <= 0, the return value Is -oo, and _fp—error is called 
with an error code of 25. 

• If arithmetic overflow occurs, the return value is +co, and —fp—error 
is called with an error code of 27. 

• If arithmetic underflow occurs, the return value Is 0, and —fp—error is 
called with an error code of 28 (see the TMS34010 C Compiler User's 
Guide for a description of the —fp—error function). 


extern double pow(); 
double X, y, z; 

X = 2.0; 
y = 3.0; 

z = pow(x, y); /* return value = 8.0 */ 
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Put Pixel Value Function 


put—pixel 


Syntax 


Description 


Example 


void put—pixel(val, x, y) 

int val; /* pixel value */ 

int X, y; /* coordinates of pixel */ 

The put—pixel function writes a value to a pixel on the screen. Argument 
val Is the value that is written to the pixel located at coordinates (x,y). 
Given a pixel size of n bits, the pixel is contained in the n LSBs of val 
(higher order bits are ignored). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


static char *s[] = { 

"Flip all", "the pixels", "in this box." 

} ; 

int i, j/ val, w, xl, yl, x2, y2; 

init—video(1); 
init—grafix(); 
init—text(); 
init—screen(); 

/*** Draw picture to be flipped ***/ 
yl = 98; 

for (i = 0; i <= 2; ++i, yl += char—high()) 
draw—string(126, yl, s[i]); 
select—patn(16); 
w = 114; 
xl = 114; 
yl = 53; 

patnframe—rect(w, w, xl, yl, 5, 14); 

/**★ Now use put—pixel function to flip pixels ***/ 

x2 = xl + 320; 

y2 = yl + 240; 

for (i = 0; i <= 113; ++i) 

for (j = 0; j <=113; ++j) { 

val = get—pixel(xl+i, yl+j); 
put—pixel(val, x2+w-j, yl+i); 
put—pixel(val, x2+w-i, y2+w-j); 
put—pixel(val, xl+w-j, y2+w-i); 

} 
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put—rect 


Syntax 


Description 


Put Rectangle Function 


void put—rect(sarray, spitch, w, h, xleft, ytop) 

short sarray[]; /* source pixel array */ 

long spitch; /* source pitch */ 

int w, h; /* destination width and height */ 

int xleft, ytop; /* destination top left corner */ 

The put—rect function copies pixels from a packed pixel array to a rectan¬ 
gular area on the screen. 

• The last four arguments define the destination rectangle: 

- The width w, 

- The height h, and 

- The coordinates of the top left corner (xleft^ytop). 
w and h must be nonnegative. 

• Argument sarray is a two-dimensional array of pixels. 

• Successive rows of the source array do not necessarily occupy con¬ 
tiguous locations In memory. The source pitch parameter, spitch, 
specifies the difference in memory addresses between adjacent rows 
of the source array. Argument spitch must be greater than or equal 
to width w times the pixel size. 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 
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Put Rectangle Function 


put—rect 


Example 


int w, h, X, y, pitch, i; 
short buf[80*60*4 / 16]; 

init—video(1); 
init—grafix(); 
init—screen(); 
w = 80; 
h = 60; 

X = 280; 
y = 210; 

pitch = w * get—psize(); 

/****************************★**/ 

/* Draw picture */ 

y'* *****************************★/ 

fill—rect (w“2 , h-*2, x+1, y+1) ; 

set-colorO(0x11111111); /* Assume 4 bits/pixel */ 

set—color1(0x44444444) ; 

patnframe—oval(w-2, h-2, x+1, y+1, 20, 15); 

/**************************★****/ 

/* Capture picture from screen */ 

y'****************** *********** **y' 

get—rect(w, h, x, y, buf, pitch); 

/*******************************/ 

/* Put picture onto screen */ 

/*******************************/ 

for (i = 25, X = 0, y = ”150<<16; i > 0; --i) { 

X += y >> 2; 
y -= X >> 2; 

put—rect(buf, pitch, w, h, (x>> 16 )+ 280 , (y>> 16 )+ 210 ); 
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rep—pixel 


Replicate Pixel Function 


Syntax 

Description 


Example 


long rep—pixel(val) 

int val; /* pixel value */ 

The rep—pixel function replicates a pixel value val throughout a 32-bit in¬ 
teger. Given a pixel size of n bits, the n LSBs of val are replicated 32/a7 
times to fill the 32-bit return value. (The higher order bits of val are Ignored 
by the function.) 

For example, given a pixel size of 4 bits and an input value of 5, the return 
value is 0x55555556. An input value of 0x1234567 produces a return va¬ 
lue of 0x77777777, and so on. 

The output of this function can be used as input for the set—colorO, 
set—colorl, and set—pmask functions. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int w, h, X, y, val; 
static char s[] = "big”; 

init—video (1) ; 
init—grafix() ; 
init—text(); 
init—screen(); 
w = get—width(s); 

h = get—ascent() + get—descent(); 
set—color1(rep—pixel(4)); 
fill—rect(w, h, 0, 0); 
set—colorO(rep—pixel(4)); 
set—color1(rep—pixel(7)); 
draw—string(0, get—ascent(), s); 
for (x = 0; X < w; ++x) 

for (y = 0; y < h; ++y) { 

val = rep—.pixel(get—pixel(x,y)); 
set—colorl(val); 

fill_rect(18, 18, 80+20*x, 80+20*y); 
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Rightmost One Function 


rmo 


Syntax 

Description 

Example 


int rmo(n) 

long n; /* 32~bit integer */ 

The rmo function calculates the bit number of the rightmost one in argu¬ 
ment n. The argument is treated as a 32-bit number whose bits are num¬ 
bered from 0 to 31, where bit 0 is the LSB (the rightmost bit position) and 
bit 31 is the MSB (the leftmost bit position). 

For nonzero arguments, the return value is in the range 0 to 31. If the ar¬ 
gument is 0, a value of -1 is returned. 

int i; 

init—video(1); 
init—grafix(); 
init—screen(); 
for (i = 1; i < 640; ++i) 

draw—line(0, i, 2 << rmo(i), i); 
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rotate 


Rotate Function 


Syntax 


Description 


void rotate(matrix, angle) 

typedef long FIX; /* define fixed-point type */ 
FIX matrix[16]; /* 4x4 transformation matrix */ 
FIX angle[3]; /* angles of rotation in radians */ 


The rotate function applies rotations in the XY, YZ, and ZX planes to a 
4x4 homogeneous transformation matrix. Once the rotation information 
is embedded in the matrix, the matrix can be used to transform the X, Y, and 
Z coordinates that represent the position of a three-dimensional object. 

• Array matrix Is a 16-element transformation matrix in row-major or¬ 
der. 

• Argument angle is a 3-element array that contains the angles of rota¬ 
tion In the three planes. Specifically, elements angle[0], angle[1] 
and angle [2] contain the angles for the XY, YZ, and ZX planes, re¬ 
spectively. The rotation angles are applied to the matrix in the order 
XY first, YZ second, and ZX third. The angles are expressed in degrees. 
Array elements are 32-bit fixed-point numbers whose 16 LSBs lie to 
the right of the binary point 

The rotate function multiplies the input matrix by the following three rota¬ 
tion matrices: 


• Rotation In the XY plane (about the Z axis). Let Z.XY = angle[0]: 


cos(AXY) -sin(AXY) 0 

sin(Z.XY) cos(Z.XY) 0 

0 0 1 

0 0 0 


0 

0 

0 

1 


• Rotation in the YZ plane (about the X axis). Let Z.YZ = angle[1]: 

1 0 0 o' 

0 cos(AYZ) -sin(£YZ) 0 

0 sin(z.YZ) cos(AYZ) 0 

0 0 0 1 


Rotation in the ZX plane (about the Y axis). 


cos(AZX) 

0 

-sin(z.ZX) 

0 


0 

1 

0 

0 


sin(z.ZX) 

0 

COS(2LZX) 

0 


Let Z-ZX = angle [2]. 

o“ 

0 

0 

1 


The function Is designed to trivially detect rotation angles of 0 degrees in 
order to avoid unnecessary computations. See Principles of Interactive 
Graphics (Newman and Sproull) for more Information on homogeneous 
transformations. 
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Rotate Function 


rotate 


Example 


typedef long FIX; 

static FIX rot[3] = { 0, 0, 0 }; 
static long xyz[] = { 

-50,-50,0, 50,-50,0, 50,50,0, -50,50,0 

} ; 

static short front[4] = { 0,1,2,3 }; 
static short back[4] = { 3,2,1,0 }; 

FIX matrix[16], verts[12]; 

short xy[8] ; 
int i, angle; 

init—video(1); 
init_grafix(); 
init—vuport(); 

set_origin(320, 240); /* Center origin */ 

/*********************************************/ 

/* Rotate the square in each of the 3 planes */ 

/*****★***************************************^ 
for (i = 0; i <= 2; ++i) 

for (angle = 0; angle <= 360; ++angle) { 
init—matrix(matrix); 
rot[i] = angle << 16; 
rotate(matrix, rot); 
long_to_fix(12, xyz, verts); 
transform(matrix, 4, verts); 
perspec(4, verts, xy, 0, -100, -300); 
delay(O) ; 
init—screen(); 

set—colorl(0x11111111); /* 4-bit pixel */ 
fill—convex(4, front, xy); 
set—color1(0x66666666); 
fill—convex(4, back, xy); 

3 
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run—decode Decode Run-Length-Encoded Image Function 


Syntax 


Description 


Exampie 


void run—decode(xleft, ytop, image) 

int xleft, ytop; /* screen rectangle coords */ 
short image[]; /* compressed image */ 

The run—decode function decodes an image previously encoded by the 
run—encode function. The decoded image is drawn to the designated area 
of the screen. 

The image is rectangular; its top left corner Is positioned at coordinates 
(xleft^ytop). The image produced by the run—decode function has the 
same dimensions as the original image captured by the run—encode func¬ 
tion. The width and height are embedded In the image array along with the 
compressed image. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 


#define MAXSIZE 4000 
char picture[MAXSIZE]; 
int X, y; 

init—video(1); 
init—grafix(); 
init—screen(); 

/★Hr*************************************/ 

/* Draw a picture */ 

/***************************************/ 

set—color1(rep—pixel(1)); 

frame—rect(98, 78, 1, 1, 8, 8); 

set—COlor1(rep—pixel(9)); 

fill—rect(84, 64, 8, 8); 

set—colorO(rep—pixel(4)); 

set—color1(rep—pixel(7)); 

patnframe—oval(92, 72, 4, 4, 26, 20); 

/****★**********************************/ 

/* Capture the picture */ 

/********★******************************/ 
run—encode(100, 80, 0, 0, picture, MAXSIZE); 

y'* *************************************★/ 

/* Draw the picture back to the screen */ 

y***************************************/ 
for (x = 0, y = 394; y > 0; x += 77, y 56) 
run—decode(x, y, picture); 
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Run-Length Encode an Image Function run—encode 


Syntax int run_encode(w, h, xleft, ytop, image, maxbytes) 

int w, h ; /* source width and height */ 

int xleft, ytop; /* screen rectangle coordinates */ 

short image[]; /* compressed image */ 

int maxbytes; /* array capacity in bytes */ 

Description The run—encode function compresses an image using run-length encoding. 

It saves the image contained in a rectangular area of the screen. The image 
is stored in the image array. 

Run-length encoding stores each horizontal line of the image as a series of 
color transitions: the color for each transition Is paired with the number of 
times the color is repeated (that is, the number of pixels in that color) before 
a transition to a new color occurs. 

Once an image is encoded using the run—encode function, it can be de¬ 
coded and drawn to the screen using the run—decode function. 

The first four arguments specify a rectangular area of the screen that Is 
compressed: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The last two arguments specify the destination array for the compressed 
image data. 

• Argument image Is an array large enough to contain the compressed 
Image. 

• Argument maxbytes is the number of 8-bit bytes available in the array 
for storing the compressed image. 

The value returned by the function is the number of 8-blt bytes actually re¬ 
quired to store the compressed Image. If the return value is larger than 
maxbytes, the function ceases writing data to the image array following 
the point at which it runs out of room In the array. 

Table 5-1 shows the format for the image array. 

Table 5-1. Image Array Format 


Byte 

Information 

0-1 

Image format identifier 

2-4 

Length of array in bytes 

5-6 

Width of image rectangle 

7-8 

Height of image rectangle 

9-10 

X coordinate at left side of rectangle 

11-12 

Y coordinate at top of rectangle 

13... 

Run-length encoded image data 
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run—encode 


Run-Length Encode an Image Function 


The first 14 bytes contain header information. The initial word is a format 
identifier that specifies the type of encoding used to compress the image. 
The next four bytes specify the number of bytes actually used to encode the 
Image (including the 14 header bytes). The next four bytes specify the 
width (two bytes) and height (two bytes) of the original rectangular region 
of the screen from which the image Is taken. The next four bytes contain 
the X (two bytes) and the y (two bytes) coordinate values (relative to the 
active viewport at the time the Image was encoded) at the top left corner 
of the screen rectangle. 

Following the header information is the actual run-length-encoded image. 
Each byte of the encoded image represents either a run-length code 
(rlcode) or a pixel value {pvalue). A positive ricode means that the byte 
following the ricode is a pvalue representing the pixel value for the next 
ricode pixels. For example, if an ricode value of +10 Is followed by a pvalue 
of 0x55, this represents a string of 10 pixels, each of color 0x55. A negative 
ricode means that the next abs(rlcode) pixels are specified as individual 
bytes. For example, an ricode value of -4 followed by 0x11, 0x22, 0x33, 
and 0x44 means that the next four pixels are of colors 0x11, 0x22, 0x33, 
and 0x44, respectively, the first byte in the image array (following the 
header) is always an ricode. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


Example 


Refer to the example In the run—decode definition. 





Scale Matrix Function 


scale 


Syntax 


Description 


Example 


void scale(matrix, factor) 

typedef long FIX; /* fixed-point type definition */ 

FIX matrix[16]; /* 4x4 transformation matrix */ 

FIX factor[3]; /* scaling factors in x, y, z */ 

The scale function applies scaling transformations in the X, Y, and Z di¬ 
mensions to a 4x4 homogeneous transformation matrix. Once the scaling 
information is embedded in the matrix, the matrix can be used to transform 
the X, Y, and Z coordinates representing the position of a three-dimensional 
object. 

• Array matrix is a 16-element transformation matrix specified in row- 
major order. 

• Argument factor is a 3-element array containing the specified scal¬ 
ing factors for the X, Y, and Z dimensions. Specifically, elements 
factor[0], factor[1] and factor[2] contain the factors for the 
X, Y, and Z dimensions, respectively. Array elements are 32-bit 
fixed-point numbers whose 16 LSBs lie to the right of the binary 
point 

A scaling matrix is constructed from the three scaling factors, and the matrix 
specified by the matrix argument is multiplied by the scaling matrix. See 
Principles of Interactive Graphics (Newman and Sproull) for more infor¬ 
mation on homogeneous transformations. 

typedef long FIX; 

static FIX factor[3] = { 0x8000, 0x8000, 0x8000 }; 
static long xyz[] = { 

-50,-50,50, 50,-50,50, 50,50,-50, -50,50,-50 

} ; 

static short object[4] = { 0,1,2,3 }; 

FIX matrix[16], verts[123; 

short xy[8]; 
int i, f ; 

init—video(1) ; 
init—grafix(); 
init—vuport() ; 

set-origin(320, 240); /* Center origin */ 

set—color1(0x11111111); /* 4-bit pixel */ 

/****★**************★****************************/ 

/* Scale the object in each of the 3 dimensions */ 

/************************************★***********/ 
for (i = 0; i <= 2; ++i) 

for (f = 0x8000; f <= 0x18000; f += 0x200) { 
init—matrix(matrix); 
factor[i] = f; 
scale(matrix, factor); 
long—to—fix(12, xyz, verts); 
transform(matrix, 4, verts); 
perspec(4, verts, xy, 0, 0, -200); 
delay(O); 
init—screen() ; 
fill—convex(4, object, xy); 

} 
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seed—fill 


Syntax 


Description 


Seed Fill Function 


void seed-_fill(xseed, yseed, buffer, maxbytes) 

int xseed, yseed; /* coordinates of seed pixel */ 

char buffer[]; /* working storage for function */ 

int maxbytes; /* size of buffer in bytes */ 

The seed—fill function fills a connected region of pixels starting at a speci¬ 
fied seed pixel. The seed color is the color of the specified seed pixel at the 
time the function Is called. The connected region is solid-fiHed with the 
current COLOR1 value. 

• The first two arguments, xseed and yseed, specify the coordinates 
of the seed pixel. 

• The last two arguments specify a buffer used as working storage 
during the seed fill. 

~ Argument buffer Is a buffer large enough to contain the tem¬ 
porary data that the function uses. 

- Argument maxbytes is the number of 8-blt bytes available In 
the buffer array. 

Storage requirements can be expected to Increase with the complexity 
of the connected region being filled. 

The connected region filled by the function always includes the seed pixel. 
To be considered part of the connected region, a pixel must both match the 
seed color, and be horizontally or vertically adjacent to another pixel that is 
part of the connected region. (A diagonally adjacent neighbor Is not suffi¬ 
cient.) 

The seed—fill function aborts (returns Immediately) if any of these condi¬ 
tions are detected: 

• The seed pixel matches the current COLOR1 value. 

• The seed pixel lies outside the current visibility rectangle (or window). 

• If at any point the storage buffer space specified by maxbytes is in¬ 
sufficient to continue. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment 
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Seed Fill Function 


seed-fill 


Example 


char buf[800] ; 
int i; 

init—video(1); 
init_grafix(); 
init—screen(); 

/* Draw a connected region */ 

/*********************★***★*******/ 

set—color1(rep—pixel(15)); 

draw—rect(63, 63, 0, 0); 

set—colorO(rep—pixel(1)); 

set—color1(0)? 

select—patn(8); 

patnfill—rect(62, 62, 1, 1); 

zoom—rect(64, 64, 0, 0, 320, 320, 160, 80, 

y*********************************/ 

/* Now fill the connected region */ 

/*********************************/ 
for (i = 2; i < 15; ++i) { 

set—color1(rep—pixel(i)); 

seed—fill( 320, 240, buf, sizeof(buf)); 

} 


buf) ; 
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seed—patnf ill 


Seed Pattern Fill Function 


Syntax 


Description 


void seed—patnfill(xseed, yseed, buffer, maxbytes) 

int xseed, yseed; /* coordinates of seed pixel */ 

char buffer[]; /* working storage for function */ 

int maxbytes; /* size of buffer in bytes */ 

The seed—patnfill function fills a connected region of pixels with a pattern, 
starting at a specified seed pixel. The seed color is the color of the specified 
seed pixel at the time the function is called. The connected region is filled 
with the current pattern in colors COLORO and COLOR1. 

• The first two arguments, (xseed, yseedO, specify the coordinates of 
the seed pixel. 

• The last two arguments specify a buffer used as working storage 
during the seed fill. 

- Argument buffer is a buffer large enough to contain the tem¬ 
porary data that the function uses. 

“ Argument maxbytes is the number of 8-bit bytes available in 
the buffer array. 

Storage requirements can be expected to Increase with the complexity 
of the connected region being filled. 

The connected region filled by the function always includes the seed pixel. 
To be considered part of the connected region, a pixel must both match the 
seed color, and be horizontally or vertically adjacent to another pixel that is 
part of the connected region. (A diagonally adjacent neighbor is not suffi¬ 
cient.) 

The seed—patnfill function aborts (returns immediately) if any of these 
conditions are detected: 

• The seed pixel matches either the current COLORO value or the cur¬ 
rent COLORl value. 

• The seed pixel lies outside the current visibility rectangle (or window). 

• If at any point the storage buffer space specified by maxbytes Is in¬ 
sufficient to continue. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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Seed Pattern Fill Function 


seed—patnf ill 


Example 


char buf[800] ; 
int i; 

init—video(1) ; 
init_grafix(); 
init_screen(); 

^*********************************^ 

/* Draw a connected region */ 

y*********************************/ 

set—color1(rep—pixel(15)); 

draw—rect(63, 63, 0, 0); 

set—COlor0(rep—pixel(1)); 

set—color1(0); 

select—patn(8) ; 

patnfill—rect(62, 62, 1, 1); 

zooni—rect (64, 64, 0, 0, 400, 400, 120, 40, buf); 

/*********************************/ 

/* Now fill the connected region */ 

^*********************************^ 
set—colorO(rep—pixel(4)) ; 
set—colorKrep—pixel(7) ) ; 

seed—patnfill( 320, 240, buf, sizeof(buf)); 
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select—font 


Select Font Function 


Syntax int select—font(index) 

int index; /* identifies a font previously opened */ 

Description The select—font function selects the font identified by index. The desig¬ 

nated font is used in all subsequent text-drawing operations within the 
current viewport until a new font is selected. 

If the font is not currently open, a value of -1 is returned to indicate an error, 
and the system font is selected as a default. Otherwise, a value of 0 Is re¬ 
turned as confirmation. 


Note: 

Before you call the select—font function, call the init—text function to 
initialize the text data structures. 


Example 

#include "fntstruc.h" 
extern FONT corpus—christi29, 
extern FONT montrose28, 
extern FONT north—pole30, 
extern FONT san—marcos21; 
int i, X, y; 
char *s; 

init—video(1); 
init—grafix(); 

init—text(); /* Corpus Christi 16 selected as default font 

V 

init—screen(); 

install—font(1, Scorpus—Christi29); /* Don’t forget the & */ 
install—font ( 2 , &niontrose28) ; 
install—font(3, Snorth-pole30); 
install—font (4 , Stsan—iiiarcos21) ; 
s = "Hello World."; 
for (i = 0, y = 0; i <= 4; ++i) { 
select—font(i); 

X = 320 - get—width(s)/2; 
y += char—high(); 
draw—string(X, y, s); 

} 


/* FONT type definition */ 
/* Corpus Christi font */ 
/* Montrose font */ 
/* North Pole font */ 
/* San Marcos font */ 
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Select Pattern Function 


select—patn 


Syntax 

Description 


Example 


int select—patn(index) 

int index; /* index into pattern table */ 

The select—patn function selects the pattern identified by the index. The 
pattern is used in all subsequent pattern-filling functions in the current 
viewport until another pattern Is selected. 

The pattern is a 16 x 16 bit map that is bit-expanded to the current COLORO 
and COLOR1 values when drawn to the screen. Argument index represents 
the position of the pattern within the pattern table. Runtime initialization 
loads the pattern table with a number of default patterns. You can use the 
install—patn function to install custom patterns. 

If argument index is negative or is greater than or equal to the value re¬ 
turned by the get—patn—max function, a value of -1 is returned to flag the 
error condition. Otherwise, a value of 0 is returned to confirm that the de¬ 
signated pattern was selected. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


int X, y, dx, dy, i, hueO, huel; 
init—video(1); 

init—grafix(); /* Initialize patterns */ 

init—screen(); 

i = get—patn_max(); 

dx = 480 / i; 

dy = 320 / i; 

x = y = 0; 

hueO = huel = 0; 

for (--i ; i >= 0; —i, x += dx, y += dy) { 
select—patn(i); 

set—color0(rep—pixel(hue0++)); 
set—color1(rep—pixel(—huel)); 
patnfill—rect(160, 160, x, y); 

} 
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select—vuport 


Select Viewport Function 


Syntax 

Description 


Example 


int select—vuport(index) 

int index; /* viewport number */ 

The select—vuport function selects the viewport identified by index. The 
designated viewport becomes the active viewport for subsequent drawing 
operations. 

The viewport must have been previously opened. At the time the viewport 
was opened, the open—vuport function returned the Index that Identifies 
the viewport in subsequent transactions. The system viewport is opened 
automatically by the viewport initialization function, init—vuport, and Is 
identified by an index value of 0. 

The attributes of the specified viewport replace those of the previously ac¬ 
tive viewport. Refer to the description of the open—vuport function for a 
list of viewport attributes. 

A value of 0 is returned if the Index is valid. In the event of an invalid index, 
a value of -1 is returned and the active viewport Is not changed. 


Note: 

Before you call the select—vuport function, call the init—vuport function 
to Initialize the viewport data structures. 


int V; 


/* Open viewport 0 */ 


init—video(1) ; 
init—grafix() 
init—vuport() ; 
init—screen() , 
set—cliprect(320, 480, 0, 0); 

/*******************************************/ 
/* Change viewport O’s colors and pattern */ 

y*******************************************y 
set—colorO(rep—pixel(1)); 
set—color1(rep—pixel(7)); 
select—patn(1); 

y* *********************★********************/ 
/* Change viewport I's colors and pattern */ 

/*************★*****************************/ 

V = open—vuport (); /* Open viewport 1 */ 

move—vuport(320, 0); 

set—colorO(rep—pixel(2)); 

set—color1(rep—pixel(12)); 

select—patn(4); 

y************************************** 

/* Display viewport O's colors and pattern */ 

y*******************************************y 

select—vuport(0); 

patnfill—oval(300, 460, 10, 10); 

y*******************************************y 
/* Display viewport I's colors and pattern */ 

y*******************************************y 

select—vuport(v); 

patnfill—rect(300, 460, 10, 10); 
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Set All Palette Function 


setall—palet 


Syntax 


Description 


void setall—palet(palet, reg—mask, n, y) 

short palet[16]; /* color palette */ 

int reg—mask; /* register-load mask */ 

int n; /* no. of lines affected */ 

int y; /* starting scan line */ 

The setall—palet function loads multiple color palette registers. This func¬ 
tion allows a designated subset of the color palette registers to be loaded 
from an array. 

The function does not necessarily alter the color palette over the entire 
screen; if desired, the function can alter the palette over only a specified 
group of scan lines. (This is facilitated by the line-load feature of the 
TMS34070 color palette chip.) 

• Argument n specifies the number of scan lines affected by the color 
palette load. 

• Argument y is the first line (lowest line number) in the affected group 
of lines. Scan lines are numbered in ascending order from top to 
bottom, with line 0 at the top of the screen. 

• A register mask, reg-mask, specifies which of the 16 color palette 
registers are loaded from the palet array. Only registers corre¬ 
sponding to 1s in the mask are loaded. Mask bits 0 through 15 con¬ 
trol the loading of registers 0 through 15. For example, a mask value 
of 0x0027 enables the loading of registers 0, 1, 2, and 5 from palet 
array members 0, 1,2, and 5. Only the 16 LSBs of the mask are used; 
the 16 MSBs are ignored. 

This function assumes that the system contains a TMS34070 color palette 
or functional equivalent. The pixel size is therefore four bits, and the palette 
contains 16 registers. The values contained In the palette registers can 
change on a line-by-line basis. 

Each 16-bit palette register is organized according to the following format: 


15 12 

11 8 

7 4 

3 0 

blu 

grn 

red 

att 


MSB LSB 


The red, green, and blue Intensity fields are 4-blt, unsigned binary numbers. 
The attribute field contains a color-repeat bit that is set to one to enable 
automatic filling by the palette device. See the TMS34070 User's Guide for 
details. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 
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setall-^palet 


Set All Palette Function 


Example 


static short mypaletL] 

= { 


OxOFFO, 

OxOEFO, 

OxODFO, 

OxOCFO, 

OxOBFO, 

OxOAFO, 

0x09F0, 

OxOSFO, 

0x07F0, 

0x06F0, 

0x05F0, 

0x04F0, 

0x03F0, 

0x02F0, 

0x0IFO, 

OxOOFO, 

OxlOFO, 

0x20F0, 

0x30F0, 

0x40F0, 

0x50F0, 

OxGOFO, 

0x70F0, 

0x80F0, 

0x90F0, 

OxAOFO, 

OxBOFO, 

OxCOFO, 

OxDOFO, 
}; 

int i; 

OxEOFO, 

OxFOFO 


init—video(1); 
init—grafix(); 
init—screen(); 





/*****************★*********************/ 
/* Fill horizontal strips in 16 colors */ 

/***************************************/ 
for (i = 0; i <= 15; t+i) { 

set—color1(rep—pixel(i)); 
fill—rect(40, 480, 40*i, 0); 

} 

y***************************************/ 
/* Change palette every 27 lines */ 

/★;»c*************************************/ 

for (i = 0; i < 15; ++i) 

setall—palet(&mypalet[i], OxFFFF, 27, 


40+i*27); 
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Set Clipping Rectangle Function 


set—cliprect 


Syntax 


Description 


Example 


void set—cliprect(w, h, xleft, ytop) 

int w, h; /* width and height of */ 

/* clipping rectangle */ 
int xleft, ytop; /* top left corner of */ 

/* clipping rectangle */ 

The set—cliprect function sets the size and position of the clipping rectangle 
for subsequent drawing operations. Drawing operations can alter only 
pixels within the visibility rectangle formed by the Intersection of: 

• The viewport 

• The clipping rectangle, and 

• The screen. 

Four arguments define the size and position of the clipping rectangle: 

• The width w, 

• The height h, and 

• The coordinates of the top left corner (xleft,ytop). 

The coordinates are expressed as displacements from the origin of the active 
viewport. If the viewport or viewport-relative origin Is moved, the clipping 
rectangle moves accordingly. 


Note: 

Before you call the set—cliprect function, call the init—vuport function 
to Initialize the viewport data structures. 


init—video(1); 
init—grafix(); 
init—vuport(); 
init—screen(); 

set—cliprect(128, 96, 64, 48); 

patnfill-rectClOOO, 1000, -100, -100); 

set—origin(175, 150); 

set—colorO(rep—pixel(1)); 

set—color1(rep—pixel(3)); 

select—patn(4); 

patnfill-oval(256, 192, -64, -48); 
move—vuport(160, 120); 
set—color1(rep—pixel(6)); 
fill-rectdOOO, 1000, -100, -100); 
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set—colorO 


Set Color 0 Function 


Syntax 


Description 


Example 


void set—colorQ(pixel—val) 

long pixel—val; /* pixel value replicated */ 

./* to 32 bits */ 

The set-—colorO function changes the GOLORO value. This is the pixel value 
to which Os in bit maps for text fonts and two-dimensional bit patterns are 
expanded as they are drawn to the screen. 

The pixel value is replicated through the entire 32-bit argument. Given a 
pixel size of n bits, the A7-bit pixel value must be replicated 22/n times. For 
example, at four bits per pixel, a value of 5 Is replicated 32/4 = 8 times to 
form the pixel—val argument value 0x55555555. 


Note: 

Before you call this function, call the Init—grafix function to Initialize the 
graphics environment. 


#include "fntstruc.h” /* Define FONT type */ 

extern FONT corpus—christi29; 

static char *s[] = { 

"0", ”1", "2", "3", 

-6”, "7", "8", "9”, 

"11", "12", "13", "14", 

} ; 

int i; 

init—video(1) ; 

init—grafix(); /* Set default colors */ 

init—text(); 

install—font(1,&corpus—christi29); /* Remember the & */ 

init—screen(); 
for (i = 0; i <= 15; ++i) { 
select—patn(i); 
set—colorO(rep-.pixel(i)); 
draw—string(i*40+5, 25, s[i]); 
patnfill—oval(30, 430, i*40+5, 50); 

} 


"4", "5", 

" 10 ", 

"15” 
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Set Color 1 Function 


set—colorl 


Syntax 


Description 


Example 


void set—color1(pixel—val) 

long pixel—val; /* pixel value replicated */ 

/* to 32 bits */ 

The set—colorl function changes the C0L0R1 value. This is the pixel value 
that is used for lines and solid fills. It Is also the value to which 1s in bit 
maps for text fonts and two-dimensional bit patterns are expanded as they 
are drawn to the screen. 

The pixel value is replicated through the entire 32-bit argument. Given a 
pixel size of n bits, the A7-bit pixel value must be replicated 32/n times. For 
example, at four bits per pixel, a value of 5 is replicated 32/4 = 8 times to 
form the pixel—val argument value 0x55555555. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


#include "fntstruc.h" /* Define FONT type */ 

extern FONT corpus—christi29; 

static char *s[] = { 

”0", "1", "2”, ”3% "S”, 

•’6% "7", ”8", ’'9”, "10”, 

"11", "12", "13", "14", "15" 

}; 

int i; 

init—video(1) ; 

init—grafix() ; /* Set default colors */ 

init—text(); 

install—font (1, Stcorpus—Christi29) ; /* Remember the & */ 
init—screen(); 
for (i = 0; i <= 15; ++i) { 
select—patn(i); 
set—.colorl(rep—pixel(i)); 
draw—string(i*40+5, 25, s[i]); 
fill-rect(30, 215, i*40+5, 50); 
patnfill-oval(30, 215, i*40+5, 265); 

} 
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set—origin 


Set Origin Function 


Syntax 


Description 


Example 


void set—origin(xO, yO) 

int xO, yO; /* displacement from viewport */ 

/* top left corner */ 

The set—origin function sets the position of the XY coordinate origin for the 
active viewport. This origin is used for subsequent drawing operations to 
the viewport. 

Arguments xO and yO define the new position of the origin as displace¬ 
ments from the top left corner of the active viewport. The clipping rectan¬ 
gle, whose position Is relative to the origin, is automatically adjusted to 
follow the change in position of the origin. If the viewport is subsequently 
moved, the origin and clipping rectangle move with it. 


Note: 

Before you call the set—origin function, call the init—vuport function to 
Initialize the viewport data structures. 


static short ptlist[] = { 

0,-10, 0,70, -4,62, 4,62, 

-10,0, 70,0, 62,-4, 62,4 

} ; 

static short axes[] = { 

0,1, 1,2, 1,3, 4,5, 5,6, 5,7 

} ; 

int i, X, y; 

init—video(1); 
init—grafix(); 
init—screen(); 

init—vuport(); /* Set default origin */ 

/**********************************************^ 
/* Move origin to various positions on screen */ 

/**********************************************/ 
for (x = 10; X < 639; x += 100) 

for (y = 10; y < 479; y += 100) { 
set— origin(x, y); 
draw—polyline(6, axes, ptlist); 

} 
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Set Palette Function 


set—paiet 


Syntax 


Description 


Example 


void set—paiet(reg, red, grn, blu) 

int reg; /* color palette register (0-15) */ 

int red, grn, blu; /* RGB intensities (0-15) */ 

The set—paiet function loads the designated color palette register with 
specified red, green, and blue intensities. The color palette is updated over 
the entire screen (all scan lines are affected). 

• Argument reg specifies a color palette register number in the range 0 
to 15. 

• Arguments red, grn, and blu specify 4-bit intensities in the range 0 
to 15. Only the four LSBs of the intensities are used; higher-order 
bits are ignored. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


int i, r, g, b; 

init—video(1); 
init—grafix(); 
clear—screen(0); 

/********************************/ 
/* Fill vertical stripes */ 

/*******************★************/ 
for (i = 0; i <= 15; ++i) { 
set—color1(rep—pixel(i)); 
fill_rect(40, 480, i*40, 0); 

} 

/********************************/ 
/* Change color palette values. */ 

/********************★****★★*****/ 
r = 15; 
g = b = 0; 

for (i = 0; i <= 15; ++i) 

set—palet(i, r—, g++, b++); 
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set—pensize 


Set Pen Size Function 


Syntax 

Description 

Example 


void set—pensize(w, h) 

int w, h; /* pen width and height */ 

The set—pensize function specifies the width and height of a rectangular 
pen for the active viewport These pen dimensions are used for any sub¬ 
sequent drawing operations that use the pen. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int ±, xl, yl, x2, y2; 

init—video(1); 
init—grafix(); 
init—vuport(); 
set—origin(320,240); 
init—screen(); 

/******************************************/ 
/* Draw lines with 50 different pen sizes */ 

/******************************************/ 
x2 = 0; 
y2 = -200; 

for (i = 50; i > 0; —i) { 
x2 y2 >> 3; 
y2 += x2 >> 3; 
xl = x2 >> 3; 
yl =y2»3; 
set—color1(rep—pixel(i)); 
set—pensize(i, i); 
pen—line(xl, yl, x2, y2); 

} 
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Set Plane Mask Function 


set—pmask 


Syntax 

Description 


Example 


void set—pmask(mask) 

long pmask; /* plane mask */ 

The set—pmask function specifies the plane mask that is used in subsequent 
drawing operations. The mask determines which bits in a pixel can be 
modified during drawing operations. The Os in the mask enable modifica¬ 
tion of the corresponding bit planes. The 1s in the mask write-protect the 
corresponding planes. 

The mask size is in principle the same as the pixel size, but it must be rep¬ 
licated through the entire 32-bit mask argument. Given a pixel size of n 
bits, the A7-bit mask value must be replicated Zl/n times. For example, at 
four bits per pixel, a mask value of 6 is replicated 32/4 = 8 times to form 
the pixel—val argument value 0x66666666. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


static short palet[] = { 

0x0000, OxOOFO, 0x6F60, OxOSEO, 
OxFOOO, OxFOFO, OxFSOO, 0x8880, 
OxFFFO, OxFFFO, OxFFFO, OxFFFO, 
OxFFFO, OxFFFO, OxFFFO, OxFFFO 

} ; 

int i, X, y, dx, dy; 

init—video(1); 
init—grafix(); 
new—screen(0, palet); 

^***************************************y' 

/* Assume 4 bits per pixel */ 

/* Write only to plane 3 */ 

^***************************************y- 

set—pmask(rep—pixel(7)); 

set—color1(rep—pixel(8)); 

patnfill—rect(480, 352, 80, 64); 

/***************************************/ 
/* Write only to planes 0, 1 and 2 */ 

/* Note that plane 3 remains unaltered */ 

/***************************************/ 

set—pmask(rep—pixel(8)); 

X = y = 0; 
dx = 28; 
dy = 13; 
i = 0; 

for ( ; ; ) { 

if (cpw(x, y) & 0x3) 
dx = -dx; 

if (cpw(x, y) & OxC) 
dy = -dy; 

X += dx; 
y += dy; 

set—color1(rep—pixel(i++)) ; 
fill-rectdOO, 100, x-50, y-50) ; 

} 
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set—ppop 


Set Pixel Processing Operation Function 


Syntax 

Description 


Example 


void set—ppop(ppop—code) 

int ppop—code; /* pixel processing operation code */ 

The set—ppop function defines the pixel processing operation for subse¬ 
quent drawing operations. The specified Boolean or arithmetic operation 
determines the manner in which source and destination pixel values are 
combined. The range for the ppop—code argument is 0 to 21. The codes 
are described in the following table: 


Code 

Replace Destination Pixel with: 

Code 

Replace Destination Pixel with: 

0 

source 

11 

NOT source AND destination 

1 

source AND destination 

12 

ail Is 

2 

source AND NOT destination 

13 

NOT source OR destination 

3 

all Os 

14 

source NAND destination 

4 

source OR NOT destination 

15 

NOT source 

5 

source EQU destination 

16 

source + destination 

6 

NOT destination 

17 

ADDS(source, destination) 

7 

source NOR destination 

18 

destination - source 

8 

source OR destination 

19 

SUBS(destination, source) 

9 

destination 

20 

MAX(source, destination) 

10 

source XOR destination 

21 

MIN(source, destination) 


The details of these operations are described in the TMS34010 User's 
Guide. 


Note: 

Before you call this function, call the init-grafix function to initialize the 
graphics environment. 


static 

short 

x[] = 

{ 300, 

500, 

20, 

123 } ; 

static 

short 

y[] = 

{ 400, 

100, 

50, 

321 } ; 

static 

short 

dx[] = 

{ 1, 2, 

3, 

4 }; 


static 

short 

dy[] = 

{ 1, 2, 

1, 

2 }; 


int 

ppop. 

j/ i; 






init—video(1) ; 
init—grafix(); 
init—screen(); 

/* Show effects of ppops 0 through 21 */ 

for (ppop =0; ; ) { 
set—ppop(ppop); 
if (++ppop > 21) 

POOD = 0; 

for (j =0; j < 1000; ++j) 

for (i = 0; i <= 3; ++i) { 

if (cpw(x[i], y[i]) & 0x3) 
dx[i] = -dx[i]; 
if (cpw(x[i], yii]) & OxC) 
dy[i] = -dy[i]; 
x[i] += dx[i]; 
y[i] += dy[i]; 
set—color1(rep—pixel(i+1)); 
fill—oval (80, 60, x[i]”40, y[i]--30); 

} 

} 
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Short to fixed-PoInt Function 


short—to—fix 


Syntax 


Description 


Example 


FIX *short_to_fix(n, in—array, out—array) 
typedef long FIX; 

int n; /* number of elements to be */ 

/* converted */ 

short in—array[]; /* array of integers */ 

FIX out—array[]; /* array of fixed-point values */ 

The short—to—fix function converts an array of short integers to fixed-point 
numbers. Elements of the input array are 16-bit 2s complement integers 
(C type short). Elements of the output array are 32-blt, 2s complement, 
fixed-point numbers whose 16 LSBs are to the right of the binary point. 
The conversion to fixed-point format is done by simply shifting the integer 
elements left by 16. 

Three input arguments are specified: 

• The number of elements n that are converted, 

• The Input array in-array, and 

• The output array out—array. 

A pointer to the first element of the output array is returned. 

The value returned by the function Is a pointer to the output array, 

out—array. 


typedef long FIX; 

static short ptlist[] = { 0,-20, 30,15, -30,15 }; 
static short triangle[] = { 0,1, 1,2, 2,0 }; 

FIX xy[6]; 
int i, j ; 

init—video(1) ; 
init—grafix(); 
init—vuport() ; 
init—screen(); 

short—to—fix(6, ptlist, xy); 
set—origin(320, 240); 
for (j =0; j < 100; ++j) { 

for (i = 0; i <= 5; ++i) 
xy[i] += xy[i] >> 4; 
fix—to—short(6, xy, ptlist); 
draw—polyline(3, triangle, ptlist); 

} 
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sin 


Sine Function 


Syntax 

Description 

Example 


double sin(x) 
double x; 

The sin function calculates the sine of an angle expressed in radians. Both 
argument x and the return value are double-precision floating-point values. 

For arguments greater than 1.0 E+8, a value of 0 is returned, and fp—error 
is called with error code = 17 (see the description of the floating-point fa¬ 
cility in the TMS34010 C Compiler User's Guide). 


extern double sin(); 
double radian, sval; 
radian = 3.1415927; 
sval = sin(radian); 


/* sin returns sval */ 
/* sin returns 0 */ 
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Hyperbolic Sine Function 


sinh 


Syntax 

Description 

Example 


double sinh(x) 
double x; 

The sinh function returns the hyperbolic sine of a real number x. Both the 
argument x and return value are double-precision floating-point values. 

extern double sinh(); 
double X, y; 

X = 0.0; 

y = sinh(x); /* return value = 0.0 */ 
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size—vuport 


Size Viewport Function 


Syntax 

Description 


Example 


int size—vuport(w, h) 

int w, h; /* width and height of viewport */ 

The size—vuport function changes the size of the active viewport. The 
viewport is rectangular. The top left corner of the viewport remains fixed 
at its original position; the lower right corner moves to expand or contract 
the viewport to w and height h. 


Note: 

Before you call the size—vuport function, call the init—vuport function 
to initialize the viewport data structures. 


int i, w, h; 

init—video(1); 
init—grafix(); 
init—vuport(); 
init—screen(); 
i = 0; 

********************************* y 
/* Show changes in size of viewport */ 

y'************************************y' 

for (w = 640, h = 480; w > 0; w -= 32, h -= 24) { 

size—vuport(w, h); 
set—color1(rep—pixel(++i)); 
fill-rect(2000, 2000, -1000, -1000); 

} 
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Square Root Function 


sqrt 


Syntax 

Description 

Example 


double sqrt(x) 
double x; 

The sqrt function calculates the square root of a real number x. 

If the argument x is negative, the square root of the absolute value of x Is 
returned, and fp—error is called with error code = 10 (see the description 
of the floating-point facility in the TMS34010 C Compiler User's Guide). 


extern double sqrt(); 
double X, y; 

X = 100.0; 

y = sqrt(x); /* return value = 10.0 */ 
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styled—line 


Styled Line Function 


Syntax 


Description 


long styled—line(xl, 
int xl, yl; /* 

int x2, y2; /* 

long style; /* 

/* 

int mode; /* 


yl, x2, y2, style, mode) 
start coordinates */ 

end coordinates */ 

32-bit repeating line-style */ 
pattern */ 

selects 1 of 2 drawing modes*/ 


The styled—line function uses Bresenham's algorithm to draw a styled line 
from point (xl,yl) to point (x2,y2). The line is a single pixel in thickness, 
and is drawn in the specified line-style pattern. 

• Arguments xl and yl specify the starting coordinates. 

• Arguments x2 and y2 specify the ending coordinates. 

• The last two arguments, style and mode, specify the line style and 
drawing mode. 

- Argument style is a long Integer containing a 32-bit repeating 
line-style pattern. Pattern bits are used in the order 0,1 ,...,31, 
where 0 is the rightmost bit (the LSB). The pattern is repeated 
modulo 32 as the line Is drawn. A bit value of 1 In the pattern 
specifies that COLOR1 is used to draw the corresponding pixel. 
A value of 0 in one of the line-style pattern bits means that the 
corresponding pixel is either drawn in COLORO (If mode = 1) 
or not drawn (if mode = 0). 

- The mode argument selects one of two drawing modes. If mode 
= 1, pixel positions corresponding to Os in the pattern are drawn 
In COLORO. If mode = 0, the COLORO pixels are not drawn; 
that is, the line skips over pixel positions corresponding to Os In 
the line-style pattern. The function uses only the LSB of mode; 
the function ignores higher-order bits of the argument. 

The value returned is the style pattern rotated left (/?-1) modulo 32, where 
n Is the number of pixels in the line drawn by the function (counting both 
the COLOR1 and COLORO pixels). This return value can be used as the 
line-style pattern for a new line that continues from the end point of the line 
just drawn. The line-style pattern will be continuous from the old line to 
the new line. 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 
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Styled Line Function 


styled—line 


Example long xl, yl, x2, y2, i, mask; 

init—video{1) ; 
init—grafix(); 
init—vuport(); 
init—screen(); 
set—origin(320, 240); 

/******************************************^ 

/* Draw spiral using styled line segments */ 

/*************★********★*******************/ 
x2 = 0; 

y2 = -20 << 16; 

mask = 0x93E493E4; /* line-style pattern */ 

for (i = 5000; i > 0; —i) { 
xl = x2; 
yl = y2; 
x2 += yl >> 4; 
y2 -= xl >> 4; 

mask = styled—line(xl>>16, yl>>16, x2>>16, y2>>16, 

mask, 0); 

} 
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tan 


Tangent Function 


Syntax 

Description 

Example 


double tan(x) 
double x; 

The tan function calculates the tangent of an angle x expressed in radians. 
Both argument x and the return value are double-precision floating-point 
values. 

If the absolute value of argument x is greater than 1 .OE+8, a value of 0 is 
returned, and fp—error is called with error code = 20 (see the description 
of the floating-point facility in the TMS34010 C Compiler User's Guide), 

extern double tan(); 
double X, y; 

X = 3.1415927/4.0; 

y = tan(x); /* return value = 1.0 */ 
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Hyperbolic Tangent Function 


tanh 


Syntax 

Description 

Example 


double tanh(x) 
double x; 

The tanh function returns the hyperbolic tangent of a real number x Both 
the argument x and the return value are double-precision floating-point 
numbers. 

extern double tanh(); 
double X, y; 

X = 0.0; 

y = tanh(x); /* return value = 0.0 */ 
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transform 


Transform Matrix Function 


Syntax. void transform (matrix, n, verts) 

typedef long FIX; /* fixed-point type definition */ 

FIX matrix[16]; /* 4x4 transformation matrix */ 
int n; /* number of vertices in vertex */ 

/* list */ 

FIX verts[]; /* vertex list (x, y, and z) */ 

Description The transform function uses a 4x4 transformation matrix to transform (ro¬ 
tate, scale and translate) a list of three-dimensional vertices. 

• The 4x4 transformation matrix, matrix, is a 16-element array of 
fixed-point values. A fixed-point value is 32 bits long, and the 16 
LSBs lie to the right of the binary point. Embedded in the matrix 
transformation is a sequence of scaling, rotation and translation op¬ 
erations. 

• Argument n specifies the number of vertices that are transformed by 
the matrix. 

• Vertex list verts is an array containing the three-dimensional coor¬ 
dinates of the n vertices. Each vertex In the array is a 96-blt value 
consisting of X, Y, and Z coordinate values in fixed-point format. 

The data structure for the vertex list, verts, is organized as follows: 

verts[0] = X coordinate at vertex 0 

verts [1 ] = Y coordinate at vertex 0 

verts [2] = Z coordinate at vertex 0 

verts [3] = X coordinate at vertex 1 

verts [4] = Y coordinate at vertex 1 

verts [5] = Z coordinate at vertex 1 


verts[3n] = X coordinate at vertex n-1 

verts [3n+1] = Y coordinate at vertex n-1 

verts[3n+2] = Z coordinate at vertex n-1 
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Transform Matrix Function 


transform 


Example 


typedef long FIX; 

static FIX rotation[] = { 0, 0, 0 }; 

static FIX xyz[] = { -150,-200,0, 150,-200,0, 0,0,0 }; 
static short connect[] = { 0, 1, 2 }; 

FIX matrix[16], verts[3*3]; 
short xy[2*3]; 
int angle; 

init—video(1); 
init—grafix(); 
init—vuport(); 
set—origin(320, 240); 
for (;;) 

for (angle = 0; angle < 360; ++angle) { 
init—matrix(matrix); 
rotation[0] = angle << 16; 
rotate(matrix, rotation); 
long—to—fix(3*3, xyz, verts); 
transform(matrix, 3, verts); 
vertex—to—point(3, verts, xy); 
delay(O); 
init—screen(); 

fill—convex(3, connect, xy); 

} 
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translate 


Syntax 


Description 


Example 


Translate Matrix Function 


void translate(matrix, disp) 
typedef long FIX; 

FIX matrix[16] /* 4x4 transformation matrix */ 

FIX disp[3] /* displacements in x, y, z */ 

The translate function multiplies a 4x4 transformation matrix by a trans¬ 
lation matrix constructed from displacements in the X, Y, and Z directions. 

• Argument matrix is a 4x4 homogeneous transformation matrix. 
Each matrix element is stored as a 32-bit fixed-point value whose 16 
LSBs lie to the right of the binary point. Refer to the definition of the 
init—matrix function for a description of the matrix structure. 

• Argument disp is a three element array containing the displacements 
in X, Y, and Z (in that order). Each displacement is stored as a 32-bit 
fixed-point value. The translation matrix by which the transformation 
matrix is multiplied is formed from the elements of the disp array as 


follows: 





1 

0 

0 

0 


0 

1 

0 

0 


0 

0 

1 

0 


disp[0] 

disp[1 ] 

disp[2] 

1 


Refer to Principles of Interactive Graphics (Newman and Sproull) for addi¬ 
tional information on homogeneous throe-dimensional transformations. 


typedef long FIX; 

static FIX rotation[3] = { 0, 0, 0 }; 

static FIX translatl[3] = { -320, -240, 0 }; 

static FIX translat2[3] = { 320, 240, 0 }; 

static long xyz[] = { 

320,40,0, 340,240,0, 320,260,0, 300,240,0 

} ; 

static short connect[8] = { 0,1, 1,2, 2,3, 3,0 }; 
FIX matrix[16]; 

FIX verts[12]; 
short xy[8]; 
int angle; 

init—video(1) ; 
init—graf ix () ; 

long—to—fix(3, translatl, translatl); 
long—to—fix(3, translat2, translat2); 
for (;;) 

for (angle = 0; angle < 360; ++angle) { 
init—matrix(matrix); 
translate(matrix, translatl); 
rotation[0] = angle << 16; 
rotate(matrix, rotation); 
translate(matrix, translat2); 
long—to—fix(12, xyz, verts); 
transform(matrix, 4, verts); 
vertex—to—point(4, verts, xy); 
delay(0); 
init—screen(); 

draw-oval(420, 420, 110, 30); 
draw—polyline(4, connect, xy); 
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Transparency Off Function 


transp—off 


Syntax 

Description 


Example 


void transp—off() 

The transp—off function disables transparency for subsequent drawing op¬ 
erations. 

When transparency is enabled, and the result of a pixel operation involving 
the source and destination pixels is 0, the destination pixel Is not altered. 
The transp—off disables transparency, and the result of a subsequent pixel 
operation is written to the destination regardless of Its value. 


Note: 

Before you call this function, call the Init—grafix function to initialize the 
graphics environment. 


init—video(1) ; 
init—grafix(); 

init—screen(); /* Sets 0 = black */ 

/***************★****★****★*******************/ 
/* Construct source array */ 

/'*********************************************/ 
frame—rect(190, 190, 25, 145, 2, 2); 
set—color1(rep—pixel(6)) ; 
frame-oval(150, 150, 45, 165, 35, 35); 

/*********************************************/ 
/* Construct 2 copies of destination */ 

y/**********:^c**********************************^ 

set—color1(rep—pixel(12)) ; 
fill-rect(190, 190, 225, 145); 
set—color1(rep—pixel(1)); 
fill-rect(30, 190, 305, 145); 
fill-rect(190, 30, 225, 225); 
move-rect(200, 200, 220, 140, 420, 140); 

/*********************************************/ 
/* Copy source to 1st dest. with transp. ON */ 

y'*********************************************y 

transp—on(); 

move—rect(160, 160, 40, 160, 240, 160); 

y*********************************************/ 
/* Copy source to 2nd dest. with transp. OFF */ 

y*********************************************y 

transp—off(); 

move—rect(160, 160, 40, 160, 440, 160); 
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transp—on 


Transparency On Function 


Syntax 

Description 


Example 


void transp—on() 

The transp—on function enables transparency for subsequent drawing op¬ 
erations. 

When transparency is enabled, and the result of a pixel operation Involving 
the source and destination pixels is 0, the destination pixel is not altered. 
The transp—on enables transparency, and the result of a subsequent pixel 
operation is written to the destination only If it Is not 0. 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 


Refer to example in description of transp—off function. 
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Vertex to Point Function 


vertex—to—point 


Syntax 


Description 


Example 


void vertex—to—point(n, verts, ptlist) 

int n; /* number of vertices to convert */ 

FIX verts[]; /* list of 3D vertices (x,y,z) */ 

short ptlist[]; /* list of 2D points (x,y) */ 

The vertex—to—point function converts a list of three-dimensional vertices 

to a list of two-dimensional points. Each three-dimensional vertex is re¬ 
presented in terms of its X, Y, and Z coordinates. Each two-dimensional 
point is represented in terms of its X and Y coordinates. 

• Argument n specifies the number of vertices that are converted. 

• Each three-dimensional vertex is represented in the verts array as 
three adjacent array elements containing the X, Y, and Z coordinate 
values, respectively. Each element Is a 32-bit fixed-point value whose 
16 LSBs lie to the right of the binary point. The number of elements 
in the verts array is three times n the number of vertices. 

• Each two-dimensional point is represented in the ptlist array as two 
adjacent elements representing the X and Y coordinate values, re¬ 
spectively. Each element is a 16-bit Integer. The number of elements 
in the ptlist array is two times n, the number of vertices. 

Each 96-bit vertex In the verts array is converted to a 32-bit point in the 
ptlist array. The function converts the integer parts of the X and Y co¬ 
ordinate values in the verts array to X and Y coordinate values in the 
ptlist array. The Z values are excluded from the ptlist array. 

Refer also to the definition of the perspec function, which similarly converts 
a list of 3D vertices to a list of 2D points, but first performs a perspective 
transformation on the vertices. 


typedef long FIX; 
static long xyz[] = { 

0 ,- 100 , 0 , 100 , 0 , 0 , 0 , 100 , 0 , - 100 , 0,0 

}; 

static short diamond[] = { 0, 1, 2, 3 }; 
FIX verts[12] ; 
short xy[8]; 

init—video(1); 
init—grafix(); 
init—vuport() ; 
set-origin(320, 240); 
init—screen(); 

long—to—fix(12, xyz, verts); 
vertex—to—point(4, verts, xy); 
patnfill—convex(4, diamond, xy); 
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wait—scan 

Syntax 

Description 


Example 


Wait for Scan Line Function 


void wait—scan(line) 

int line; /* wait until this scan line is reached */ 

The wait—scan function waits for a scan line on the CRT to be refreshed. 
This function does not return control to the calling routine until the speci¬ 
fied line is scanned by the electron beam. Control Is returned at the start 
of the horizontal blanking interval that follows the designated line. Scan 
lines are numbered in ascending order, starting with line 0 at the top of the 
screen. Only visible scan lines are counted. 

You can use this function to synchronize drawing operations to the electron 
beam of a CRT display. For example, when drawing an animated sequence 
of frames, transitions from one frame to the next appear smoother if an area 
of the screen is not redrawn at the same time it Is output to the CRT. 

If argument line < 0, the function uses the value 0 in place of the argu¬ 
ment value. If line is greater than the bottom scan line, the function uses 
the number of the bottom scan line In place of the argument value. 

The wait—scan function cannot be used in an application In which the dis¬ 
play interrupt Is enabled. If the display interrupt is enabled, the function 
returns immediately (no error code is returned). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment. 


int r, X, Y, vx, vy; 

init—video(1); 
init—grafix() ; 
init—vuport(); 
r = 100; 

X = 320; 

Y = 240; 
vx = 1 ; 
vy = ~3; 

/********************************************/ 
/* Wait only if ball is on left side of CRT */ 

/**★************★*************************★**/ 
for ( ; ; ) { 

if (cpw(x, y) & 3) 
vx = -vx; 

if (cpw(x, y) & 12) 
vy = -vy; 

X += vx; 
y += vy; 
if (x < 320) 

wait—scan(y+r); 
clear—screen(0); 
init—palet(); 

fill—oval(2*r, 2*r, x-r, y-r); 

} 
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Convert (x,y) to Address Function 


xytoaddr 


Syntax 

Description 

Example 


long xytoaddr(x, y) 

int X, y; /* viewport-relative x and y coordinates */ 

The xytoaddr function calculates the 32-bit memory address of the pixel 
located at viewport-relative coordinates (x,y). 


Note: 

Before you call this function, call the init—grafix function to initialize the 
graphics environment 


int w, h, X, y, saddr , sptch; 
char *s; 

init—video(1); 
init—grafix(); 
init—text(); 
init—screen(); 

X = y = 100 ; 

s = "Use cheap trick to slant characters."; 
draw—string(x, y, s); 

/********************************************* 

/* Calculate address at top left corner of text */ 

^★***********************************************y 
saddr = xytoaddr(x - char—highO, y - get—ascent()) ; 
sptch = peek-hregO) + get_psize(); /* SPTCH+PSIZE */ 
h = char—high(); 
w = get—width(s) + h; 

/************************************************/ 

/* Treat region of screen as source pixel array */ 

/************************************************/ 
put—rect(saddr, sptch, w, h, x, y + h); 
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zoom—rect 


Syntax 


Description 


Zoom Rectangle Function 


void zoonu-rect(ws, hs, xs, ys, wd, hd, xd, yd, linebuf) 
int ws, hs; /* source width and height */ 

int xs, ys; /* source top left corner */ 

int wd, hd; /* destination width and height */ 

int xd, yd; /* destination top left corner */ 

short linebuf[]; /* scan line buffer */ 

The zoom—rect function expands or shrinks a source rectangle on the 
screen to fit the dimensions of a destination rectangle that is on the screen. 
Horizontal zooming Is accomplished by replicating (if expanding) or delet¬ 
ing (if shrinking) columns of pixels from the source array. Vertical zooming 
is accomplished by replicating or deleting rows of pixels. This type of 
function is sometimes referred to as a "stretch blit." 

• The first four arguments define the source rectangle: 

~ The width ws, 

- The height hs, and 

- The coordinates (xs,ys) at the top left corner of the rectangle, 
ws and hs must be nonnegative. 

• The next four arguments define the destination rectangle: 

— The width wd, 

- The height hd, and 

- The coordinates (xs,ys) at the top left corner of the rectangle, 
wd and hd must be nonnegative. 

• The final argument, linebuf, is a buffer large enough to contain one 
complete line of the display. The function uses the buffer as tempo¬ 
rary working storage; the buffer's original contents are destroyed. The 
minimum buffer size (in bits) Is the number of pixels per line times the 
number of bits per pixel. 

This zoom function either expands or shrinks the source array, depending 
on Its dimensions relative to the destination rectangle. Shrinking collapses 
several pixels in the source array into a single pixel In the destination rec¬ 
tangle. The source pixels collapsed In this manner are combined according 
to the current pixel processing operation (see the set—ppop function). For 
example, the replace operation simply selects a single source pixel to rep¬ 
resent ail the source pixels in the region being collapsed. A better result can 
often be obtained using a logical-OR operation (at one bit per pixel) or a 
max operation (at multiple bits per pixel). 


Note: 

Before you call this function, call the init—grafix function to Initialize the 
graphics environment. 
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Zoom Rectangle Function 


zoom—rect 


Example 


/* Assume pixel size is 4 bits */ 

y'*******************************************y 

typedef struct { unsigned pixelsize : 4; } PIXEL; 
static PIXEL image[] = { 

6 , 7 , 6 , 7 , 6 , 7 , 7 , 7 , 6 , 7 , 6 , 6 , 6 , 7 , 6 , 6 , 6 , 7 , 7 , 7 , 6 , 

4.7.4.7.4.7.4.4.4.7.4.4.4.7.4.4.4.7.4.7.4, 

5.7.7.7.5.7.7.5.5.7.5.5.5.7.5.5.5.7.5.7.5, 
1,7,1,7,1,7,1,1,1,7,1,1,1,7,1,1,1,7,1,7,1, 

3 , 7 , 3 , 7 , 3 , 7 , 7 , 7 , 3 , 7 , 7 , 7 , 3 , 7 , 7 , 7 , 3 , 7 , 7 , 7,3 

} ; 

PIXEL buf[4*640]; /* screen width = 640 */ 

int wd, hd, xd, yd; 


init—video(1); 
init_grafix{ ) ; 
init—screen(); 

put—rect(image, 21*4, 21, 5, 0, 0); 
wd = 42; 
hd = 10; 
xd = 4; 
yd = 6; 

while (wd < 300) C 

zoom—rect(21, 5, 0, 0, wd, hd, xd, yd, buf); 


xd 

+= wd 

/ 

8; 

yd 

+= hd 

+ 

1; 

wd 

+= wd 

/ 

8; 

hd 

+= hd 

/ 

8; 


} 


5-183 







Index 


A 


acos 3-2, 5-2 
add—text—space 4-10,5-3 
archive files 2-6 
archiver 1 -2, 1 -3, 2-6 
ascent 4-12 
asin 3-2, 5-4 
assembler 1 -2, 1 -3, 2-5 
assembly language development 
flow 1 -2 
atan 3-2, 5-5 
atan2 3-2, 5-6 


B 


batch files 2-4 
bit—expand 4-24, 5-7 
bound-fill 4-17, 5-9 
bound—patnfill 4-17, 5-11 


c 

C compiler 1 -3, 1 -5, 2-5 
calling functions 2-5 

char-high 4-10, 4-12, 5-14 
charpatn array 4-13 
char—wide—max 4-10,5-15 
clear—screen 4-6, 4-38, 5-16 
clipping rectangles 4-25 
close—vuport 4-27,5-17 
color palette functions 4-23 
color-blend 4-23, 4-38, 5-18 
compiling a program 2-5 
copy—matrix 4-7,5-19 
copy—vertex 4-7, 5-20 
copy—vuport 4-27, 5-21 
cos 3-2, 5-22 
cosh 3-2, 5-23 
cotan 3-2, 5-24 
cpw 4-27, 5-25 


D 


delay 4-28, 5-27 
descent 4-12 

development tools pverview 1 -2 
draw—char 4-8, 5-28 
drawing styles 4-16 
draw—line 4-17, 5-29 
draw—oval 4-17,5-30 
draw—ovalarc 4-17,5-31 
draw—piearc 4-17,5-32 
draw—point 4-17, 5-33 
draw—polyline 4-17,5-34 
draw—rect 4-17,5-36 
draw-string 4-8, 5-37 


E 


exp 3-2, 5-38 


F 


fabs 3-2, 5-39 
figure shapes 4-16 
fill patterns 4-20 
fill—convex 4-17,5-40 
fill-oval 4-17, 5-42 
fill—piearc 4-17,5-43 
fill-polygon 4-17,5-45 
flll-rect 4-17, 4-33, 5-47 
firstchar 4-12 
fix—to—float 3-4, 5-48 
fix—to—long 3-4, 5-49 
fix—to—short 3-4, 5-50 
FIX2FL 3-4, 5-51 
FL-ADD 3-4, 5-53 
FL-COS 3-4, 5-54 
FL-MULT 3-4,5-55 
float—to—fix 3-4, 5-57 
floor 5-58 


Index-1 


FL-SIN 3-4, 5-56 
FL2FIX 3-4,5-52 
fmod 3-2, 5-59 
font library 1-5,4-11 
font management 4-11 
fonts 4-14 
fonttype 4-12 
frame—oval 4-17,5-60 
frame—rect 4-17,5-61 
frectwide 4-12 
frexp 5-62 
function library 

in the development flow 1 -2 


G 


getall—palet 4-23, 4-38, 5-63 
get—ascent 4-10,5-64 
get—descent 4-10, 5-65 
get—first—ch 4-10, 5-66 
get—font—max 4-11,5-67 
get—last—ch 4-10,5-68 
get—leading 4-10, 5-69 
get—patn—max 4-19,5-70 
get—pixel 4-24, 5-71 
get—pmask 4-19, 5-72 
get—ppop 4-19,5-73 
get—psize 4-19, 5-74 
get—rect 4-24,5-75 
get—transp 4-19,5-77 
get—vuport—max 4-27, 5-78 
get—width 4-10, 5-79 
graphics attributes 4-19 
graphics output functions 4-16 
graphics system initialization 4-6 
gspc.bat 2-5, 2-6 


H 


how to use this manual 1 -4 


I 


init—grafix 4-6, 5-80 
init—matrix 4-7, 5-81 
init—palet 4-6, 4-38, 5-83 
init-screen 4-6, 4-38, 5-84 
init-text 5-85 
init—video 4-6, 4-38, 5-86 
init-vuport 4-6, 4-27, 5-88 
Installation 2-1 
MS-DOS 2-2 
PC-DOS 2-2 
VAX/System V 2-3 
VAX/ULTRIX 2-3 
VAX/VMS 2-3 
install—font 4-11,5-89 
install—patn 4-19,5-90 
instruction set 1 -5 


K 


kernmax 4-12 


L 


lastchar 4-12 
Idexp 5-91 
leading 4-12 
lib-id 4-28, 5-92 
line list 4-29, 4-31 
linker 1 -2, 1 -3, 2-5 
Imo 4-28, 5-93 
loctable array 4-13 
log 3-2, 5-94 
loglO 3-2,5-95 
long—to—fix 3-4, 5-96 


M 


manual organization 1 -4 
modf 5-97 

move—pixel 4-24, 5-98 
move—rect 4-24, 5-99 
move—vuport 4-27,5-100 
MS-DOS software installation 2-2 


Index-2 



N R 


ndescent 4-12 

new—screen 4-6,4-38,5-101 


o 


object format converter 1 -2 
object libraries 1 -2, 2-4 
open—vuport 4-27,5-102 
operation 2-1 
owtable array 4-13 
owtioc 4-12 


p 


patnfill—convex 4-17,5-103 
patnfill—oval 4-17,5-105 
patnfill—piearc 4-17,5-106 
patnfill—polygon 4-17,5-108 
patnfill—rect 4-17, 5-110 
patnframe—oval 4-17,5-111 
patnframe—rect 4-17,5-112 
patnpen—line 4-17, 5-113 
patnpen—ovalarc 4-17, 5-114 
patnpen—piearc 4-17, 5-116 
patnpen—point 4-17, 5-118 
patnpen—polyline 4-17, 5-119 
PC-DOS software installation 2-2 
peek 4-28,5-121 
peek—breg 4-28,5-122 
pen—line 4-17,5-123 
pen—ovalarc 4-17, 5-124 
pen—piearc 4-17, 5-126 
pen—point 4-17,5-128 
pen—polyline 4-17,5-129 
perspec 4-7,5-131 
pixel functions 4-24 
point list 4-29, 4-30 
poke 4-28,5-134 
poke—breg 4-28,5-135 
pow 3-2,5-136 
put—pixel 4-24, 5-137 
put—rect 4-24,5-138 


related documentation 1-5 
rep—pixel 4-28, 5-140 
rmo 4-28,5-141 
rotate 4-7,5-142 
rowwords 4-13 
run—decode 4-24,5-144 
run—encode 4-24,5-145 


s 


scale 4-7,5-147 
SDB 1-5 

seed-fill 4-17, 5-148 
seed—patnfill 4-17,5-150 
select—font 4-11, 5-1 52 
select—patn 4-19,5-153 
select—vuport 4-27,5-154 
setall—palet 4-23, 4-38, 5-155 
set—cliprect 4-27,5-157 
set—colorO 4-19, 5-158 
set—colorl 4-19,5-159 
set—origin 4-27,5-160 
set—palet 4-23, 4-38, 5-161 
set—pensize 4-19,5-162 
set—pmask 4-19, 5-163 
set—ppop 4-19, 5-164 
short—to—fix 3-4,5-165 
simulator 1 -2 
sin 3-2,5-166 
sinh 3-2,5-167 
size—vuport 4-27,5-168 
software development board 1 -5 
source libraries 2-4 
sqrt 5-169 

style and symbol conventions 1 -6 
styled—line 4-17,5-170 
support tools 1 -2 


T 


tan 3-2,5-172 
tanh 3-2,5-173 
text attribute functions 4-9 
text output functions 4-8 
transform 4-7,5-174 
transformation matrix 4-29 
translate 4-7,5-176 
transp—off 4-19,5-177 


Index-3 




transp—on 4-19, 5-178 


X 


V 


xytoaddr 4-28,5-181 


VAX/System V software installation 2-3 
VAX/ULTRIX software installation 2-3 
VAX/VMS software installation 2-3 
vertex list 4-29 
vertex—to~point 4-7,5-179 
viewport management 4-25 


w 


z 


zoom—rect 4-24, 5-182 


3 


3D transformations 4-7 


wait—scan 4-28, 5-180 
widemax 4-12 


Index-4 





TI Worldwide 
Sales Offices 


ALABAMA: Huntsville: 500 Wynn Drive, Suite 514, 
Huntsville, AL 35805, (205) 837-7530. 

ARIZONA: Phoenix: 8825 N, 23rd.Ave., Phoenix, 

AZ 85021, (602) 995-1007, 

CALIFORNIA: Irvine: 17891 Cartwright Rd., Irvine, 

CA 92714, (714) 660-8187; Sacramento: 1900 Point 
West Way, Suite 171, Sacramento, CA 95815, 

(916) 929-1521; San Diego: 4333 View Ridge Ave., 
Suite B., San Diego, CA 92123, (619) 278-9601; 

Santa Clara: 5353 Betsy Ross Dr., Santa Clara, CA 
95054, (408) 980-9000; Torrance: 690 Knox St., 
Torrance, CA 90502, (213) 217-7010; 

Woodland Hills: 21220 Erwin St., Woodland Hills, 

CA 91367, (818) 704-7759. 

COLORADO: Aurora: 1400 S. Potomac Ave,, 

Suite 101, Aurora, CO 80012, (303) 368-8000. 

CONNECTICUT: Wallingtord: 9 Barnes Industrial 
Park Rd., Barnes Industrial Park, Wallingford, 

CT 06492, (203) 269-0074. 

FLORIDA: Ft. Lauderdale: 2765 N.W, 62nd St., 

Ft, Lauderdale, FL 33309, (305) 973-8502; 

Maitland: 2601 Maitland Center Parkway, 

Maitland, FL 32751, (305) 660-4600; 

Tampa: 5010 W. Kennedy Blvd., Suite 101, 

Tampa, FL 33609, (813) 870-6420. 

GEORGIA: Norcross: 5515 Spalding Drive, Norcross. 
GA 30092, (404) 662-7900 

ILLINOIS: Arlington Heights: 515 W Algonquin, 
Arlington Heights, IL 60005, (312) 640-2925. 

INDIANA: Ft. Wayne: 2020 Inwood Dr., Ft. Wayne, 

IN 46815, (219) 424-5174; 

Indianapolis: 2346 S. Lynhurst, Suite J-400, 
Indianapolis, IN 46241, (317) 248-8555. 

IOWA: Cedar Rapids: 373 Collins Rd. NE, Suite 200, 
Cedar Rapids, lA 52402, (319) 395-9550. 

MARYLAND: Baltimore: 1 Rutherford Pi., 

7133 Rutherford Rd., Baltimore, MD 21207, 

(301) 944-8600. 

MASSACHUSETTS: Waltham: 504 Totten Pond Rd , 
Waltham, MA 02154, (617) 895-9100. 

MICHIGAN: Farmington Hills: 33737 W 12 Mile Rd , 
Farmington Hills, Ml 48018, (313) 553-1500. 

MINNESOTA: Eden Prairie: 11000 W 78th St, 

Eden Prairie, MN 55344 (612) 828-9300. 

MISSOURI: Kansas City: 8080 Ward Pkwy., Kansas 
City, MO 64114, (816) 523-2500; 

St. Louis: 11816 Borman Drive, St. Louis, 

MO 63146, (314) 569-7600. 

NEW JERSEY: Iselin: 485E U S. Route 1 South, 
Parkway Towers, Iselin, NJ 08830 (201) 750-1050 

NEW MEXICO: Albuquerque: 2820-D Broadbent Pkwy 
NE, Albuquerque, NM 87107, (505) 345-2555. 

NEW YORK: East Syracuse: 6365 Collamer Dr., East 
Syracuse, NY 13057, (315) 463-9291; 

Endicott: 112 Nanticoke Ave., P.O. Box 618, Endicott, 
NY 13760, (607) 754-3900; Melville: 1 Huntington 
Quadrangle, Suite 3C10, P.O. Box 2936, Melviile,. 

NY 11747, (516) 454-6600; Pittsford: 2851 Clover St., 
Pittsford, NY 14534, (716) 385-6770; 

Poughkeepsie; 385 South Rd., Poughkeepsie, 

NY 12601, (914) 473-2900. 

NORTH CAROLINA: Charlotte: 8 Woodlawn Green, 
Woodlawn Rd., Charlotte, NC 28210, (704) 527-0930; 
Raleigh: 2809 Highwoods Blvd., Suite 100, Raleigh, 
NC 27625, (919) 876-2725. 

OHIO: Beachwood: 23408 Commerce Park Rd., 
Beachwood, OH 44122, (216) 464-6100; 

Dayton: Kingsley Bldg., 4124 Linden Ave., Dayton, 
OH 45432, (513) 258-3877. 

OREGON: Beaverton: 6700 SW 105th St., Suite 110, 
Beaverton, OR 97005, (503) 643-6758. 


PENNSYLVANIA: Ft. Washington: 260 New York Dr. 
Ft. Washington, PA 19034, (215) 643-6450; 
Coraopolis: 420 Rouser Rd., 3 Airport Office Park, 
Coraopolis, PA 15108, (412) 771-8550. 

PUERTO RICO; Hato Roy: Mercantil Plaza Bldg., 
Suite 505, Hato Rey, PR 00919, (809) 753-8700 

TEXAS: Austin: P.O Box 2909, Austin, TX 78769, 
(512) 250-7655; Richardson: 1001 E. Campbell Rd , 
Richardson, TX 75080, 

(214) 680-5082; Houston: 9100 Southwest Frwy., 
Suite 237, Houston, TX 77036, (713) 778-6592; 

San Antonio: 1000 Central Parkway South, 

San Antonio, TX 78232, (512) 496-1779. 

UTAH: Murray: 5201 South Green SE, Suite 200, 
Murray, UT 84107, (801) 266-8972, 

VIRGINIA: Fairfax: 2750 Prosperity, Fairfax, VA 
22031, (703) 849-1400. 

WASHINGTON: Redmond: 5010 148th NE, Bldg B, 
Suite 107, Redmond, WA 98052, (206) 881-3080. 

WISCONSIN: Brookfield: 450 N. Sunny Slope, 

Suite 150, Brookfield, Wl 53005, (414) 785-7140. 

CANADA: Nepean: 301 Moodie Drive, Mallorn 
Center, Nepean, Ontario, Canada, K2H9C4, 

(613) 726-1970. Richmond Hill: 280 Centre St. E„ 
Richmond Hill L4C1B1, Ontario. Canada 
(416) 884-9181; SI. Laurent: Ville St. Laurent Quebec. 
9460 Trans Canada Hwy,, St. Laurent, Quebec, 
Canada H4S1R7, (514) 335-8392. 


ARGENTINA: Texas Instruments Argentina 
S.A.I.C.F.: Esmeralda 130, 15th Floor, 1035 Buenos 
Aires, Argentina, 1 +394-3008. 

AUSTRALIA (& NEW ZEALAND): Texas Instruments 
Australia Ltd.: 6-10 Talavera Rd., North Ryde 
(Sydney), New South Wales, Australia 2113, 

2 + 887-1122; 5th Floor, 418 St. Kilda Road. 
Melbourne, Victoria, Australia 3004, 3 + 267-4677; 

171 Philip Highway, Elizabeth, South Australia 5112, 
8 + 255-2066. 

AUSTRIA: Texas Instruments Ges.m.b.H.: 
Industriestrabe B/16, A-2345 Brunn/Gebirge, 
2236-846210. 

BELGIUM: Texas Instruments N.V. Belgium S.A.: 
Mercure Centre, Raketstraat 100, Rue de la Fusee, 
1130 Brussels, Belgium, 2/720.80.00. 

BRAZIL: Texas Instruments Electronicos do Brasil 
Ltda.; Rua Paes Leme, 524-7 Andar Pinheiros, 05424 
Sao Paulo, Brazil, 0815-6166. 

DENMARK: Texas Instruments A/S, Mairelundvej 
46E. DK-2730 Herlev, Denmark, 2 - 91 74 00. 

FINLAND: Texas Instruments Finland OY: 
Teollisuuskatu 19D 00511 Helsinki 51, Finland, (90) 
701-3133. 

FRANCE: Texas Instruments France: Headquarters 
and Prod. Plant, BP 05, 06270 Villeneuve-Loubet, 

(93) 20-01-01; Paris Office, BP 67 8-10 Avenue 
Morane-Saulnier, 78141 Velizy-Villacoublay, 

(3) 946-97-12; Lyon Sales Office, L’Oree D’Ecully, 
Batiment B, Chemin de la Forestiere, 69130 Ecully, 
(7) 833-04-40; Strasbourg Sales Office, Le Sebastopol 
3, Quai Kleber, 67055 Strasbourg Cedex, 

(88) 22-12-66; Rennes, 23-25 Rue du Puits Mauger, 
35100 Rennes, (99) 31-54-86; Toulouse Sales Office, 
Le Peripole—2, Chemin du Pigeonnier de la Cepiere, 
31100 Toulouse, (61) 44-18-19; Marseille Sales Office, 
Noilly Paradis—146 Rue Paradis, 13006 Marseille, 
(91) 37-25-30. 
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GERMANY (Fed. Republic of Germany): Texas 
Instruments Deutschland GmbH: Haggertystrasse 1, 
D-8050 Freising, 8161 +80-4591; Kurfuerstendamm 
195/196, D-1000 Berlin 15, 30 + 882-7365; III, Hagen 
43/Kibbelstrasse, .19, D-4300 Essen, 201-24250; 
Frankfurter Allee 6-8, D-6236 Eschborm 1, 

06196 + 8070; Hamburgerstrasse 11, D-2000 Hamburg 
76, 040 + 220-1154, Kirchhorsterstrasse 2, D-3000 
Hannover 51, 511 +648021; Maybachstrabe 11, 

D-7302 Ostfildern 2-Nelingen, 711 +547001; 

Mixikoring 19, D-2000 Hamburg 60, 40 + 637 + 0061; 
Postfach 1309, Roonstrasse 16, D-5400 Koblenz, 

261 + 35044. 

HONG KONG (+ PEOPLES REPUBLIC OF CHINA): 

Texas Instruments Asia Ltd., 8th Floor, World 
Shipping Ctr., Harbour City, 7 Canton Rd., Kowloon, 
Hong Kong, 3 + 722-1223. 

IRELAND; Texas Instruments (Ireland) Limited' 
Brewery Rd., Sfillorgan, County Dublin, Eire, 

1 831311. 

ITALY: Texas Instruments Semiconduttori Italia Spa: 
Viale Delle Scienze, 1, 02015 Cittaducale (Rieti), 

Italy, 746 694.1; Via Salaria KM 24 (Palazzo Cosma), 
Monterotondo Scalo (Rome), Italy, 6 + 9003241; Viale 
Europe, 38-44, 20093 Cologno Monzese (Milano), 

2 2532541; Corso Svizzera, 185, 10100 Torino, Italy, 

11 774545; Via J. Barozzi 6, 40100 Bologna, Italy, 51 
355851. 

JAPAN; Texas Instruments Asia Ltd.: 4F Aoyama 
Fuji Bldg., 6-12, Kita Aoyama 3-Chome, Minato-ku, 
Tokyo, Japan 107, 3-498-2111; Osaka Branch, 5F, 
Nissho Iwai Bldg., 30 Imabashi 3- Chome, 

Higashi-ku, Osaka, Japan 541, 06-204-1881; Nagoya 
Branch, 7F Daini Toyota West Bldg., 10-27, Meieki 
4-Chome, Nakamura-ku Nagoya, Japan 
450, 52-583-8691. 

KOREA; Texas Instruments Supply Co.. 3rd Floor, 
Samon Bldg., Yuksam-Dong, Gangnam-ku, 

135 Seoul, Korea, 2 + 462-8001. 

MEXICO: Texas Instruments de Mexico S.A.: Mexico 
City, AV Reforma No. 450 — 10th Floor, Mexico, 

D.F., 06600, 5 + 514-J003. 

MIDDLE EAST: Texas Instruments: No. 13, 1st Floor 
Mannai Bldg., Diplomatic Area, P.O. Box 26335, 
Manama Bahrain, Arabian Gulf, 973 + 274681. 

NETHERLANDS: Texas Instruments Holland B.V., 
P.O. Box 12995, (Bullewijk) 1100 CB Amsterdam, 
Zuid-Oosf, Holland 20 + 5602911. 

NORWAY: Texas Instruments Norway A/S: PB106, 
Refstad 131, Oslo 1, Norway, (2) 155090. 

PHILIPPINES: Texas Instruments Asia Ltd.: 14th 
Floor, Ba- Lepanto Bldg., 8747 Paseo de Roxas, 
Makati, Metro Manila, Philippines, 2 + 8188987. 

PORTUGAL: Texas Instruments Equipamento 
Electronico (Portugal), Lda.. Rua Eng. Frederico 
Ulrich, 2650 Moreira Da Maia, 4470 Maia, Portugal, 
2-948-1003. 

SINGAPORE (+ INDIA, INDONESIA, MALAYSIA, 
THAILAND): Texas Instruments Asia Ltd.: 12 Lorong 
Bakar Batu, Unit 01-02, Kolam Ayer Industrial Estate, 
Republic of Singapore, 747-2255. 

SPAIN: Texas Instruments Espana, S.A.: C/Jose 
Lazaro Galdiano No. 6, Madrid 16, 1/458.14.58. 

SWEDEN: Texas Instruments International Trade 
Corporation (Sverigefilialen): Box 39103, 10054 
Stockholm, Sweden, 8 - 235480. 

SWITZERLAND: Texas Instruments, Inc., Reidstrasse 
6, CH-8953 Dietikon (Zuerich) Switzerland, 

1-740 2220. 

TAIWAN: Texas Instruments Supply Co.: Room 903, 
205 Tun Hwan Rd., 71 Sung-Kiang Road, Taipei, 
Taiwan, Republic of China, 2 + 521-9321. 

UNITED KINGDOM: Texas Instruments Limited: 
Manton Lane, Bedford, MK41 7PA, England, 0234 
67466; St. James House, Wellington Road North, 
Stockport, SK4 2RT, England, 61 +442-7162. 
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TI Sales Offices 

ALABAMA: Huntsville (205) 837-7530. 

ARIZONA: Phoenix (602) 995-1007; 

Tucson (602) 624-3276. 

CALIFORNIA: Irvine (714) 660-1200; 

Sacramento (916) 929-0197; 

San Diego (619) 278-9600; 

Santa Clara (408) 980-9000; 

Torrance (213) 217-7000; 

Woodland Hills (818) 704-7759. 

COLORADO: Aurora (303) 368-8000. 

CONNECTICUT: Wallingford (203) 269-0074. 

FLORIDA: Altamonte Springs (305) 260-2116; 

Ft. Lauderdale (305) 973-8502; 

Tampa (813) 286-0420. 

GEORGIA: Norcross (404) 662-7900. 

ILLINOIS: Arlington Heights (312) 640-3000. 

INDIANA: Carmel (317) 573-6400; 

Ft. Wayne (219) 424-5174. 

IOWA: Cedar Rapids (319) 395-9550. 

KANSAS: Overland Park (913) 451-4511. 

MARYLAND: Baltimore (301) 944-8600. 
MASSACHUSETTS: Waltham (617) 895-9100. 

MICHIGAN: Farmington Hills (313) 553-1500; 

Grand Rapids (616) 957-4200. 

MINNESOTA; Eden Prairie (612) 828-9300. 

MISSOURI: St. Louis (314) 569-7600. 

NEW JERSEY: Iselin (201) 750-1050. 

NEW MEXICO: Albuquerque (505) 345-2555. 

NEW YORK: East Syracuse (315) 463-9291; 

Melville (516) 454-6600; Pittsford (716) 385-6770; 
Poughkeepsie (914) 473-2900. 

NORTH CAROLINA: Charlotte (704) 527-0930; 

Raleigh (919) 876-2725. 

OHIO; Beachwood (216) 464-6100; 

Dayton (513) 258-3877. 

OREGON; Beaverton (503) 643-6758. 

PENNSYLVANIA: Blue Bell (215) 825-9500. 

PUERTO RICO: Hato Rey (809) 753-8700. 
TENNESSEE: Johnson City (615) 461-2192. 

TEXAS: Austin (512) 250-6769; 

Houston (713) 778-6592; Richardson (214) 680-5082; 
San Antonio (512) 496-1779. 

UTAH: Murray (801)266-8972. 

VIRGINIA: Fairfax (703) 849-1400. 

WASHINGTON; Redmond (206) 881-3080. 
WISCONSIN: Brookfield (414) 782-2899. 

CANADA: Nepean, Ontario (613) 726-1970; 

Richmond Hill, Ontario (416) 884-9181; 

St. Laurent, Quebec (514) 336-1860. 

TI Regional 
T^hnology Centers 

CALIFORNIA: Irvine (714) 660-8140; 

Santa Clara (408) 748-2220; 

Torrance (213) 217-7019. 

COLORADO: Aurora (303) 368-8000. 

GEORGIA: Norcross (404) 662-7945. 

ILLINOIS Arlington Heights (313) 640-2909. 
MASSACHUSETTS: Waltham (617) 895-9196. 

TEXAS: Richardson (214) 680-5066. 

CANADA: Nepean, Ontario (613) 726-1970. 


TI Distributors 


TI AUTHORIZED DISTRIBUTORS 
Arrow/Kierulff Electronics Group 
Arrow Canada (Canada) 

Future Electronics (Canada) 

GRS Electronics Co., Inc. 
Hall-Mark Electronics 
Marshall Industries 
Newark Electronics 
Schweber Electronics 
Time Electronics 
Wyle Laboratories 
Zeus Components 

-OBSOLETE PRODUCT ONLY- 
Rochester Electronics, Inc. 
Newburyport, Massachusetts 
( 617 ) 462-9332 


ALABAMA: Arrow/Kierulff (205) 837-6955; 

Hall-Mark (205) 837-8700; Marshall (205) 881-9235; 
Schweber (205) 895-0480. 

ARIZONA: Arrow/Kierulff (602) 437-0750; 

Hall-Mark (602) 437-1200; Marshall (602) 496-0290; 
Schweber (602) 997-4874; Wyle (602) 866-2888. 

CALIFORNIA: Los Angeles/Orange County: 

Arrow/Kierulff (818) 701-7500, (714) 838-5422; 

Hall-Mark (818) 716-7300, (714) 669-4100, 

(213) 217-8400; Marshall (818) 407-0101, (818) 459-5500, 
(714) 458-5395; Schweber (818) 999-4702; 

(714) 863-0200, (213) 320-8090; Wyle (213) 322-9953, 
(818) 880-9000, (714) 863-9953; Zeus (714) 921-9000; 
Sacramento: Hall-Mark (916) 722-8600; 

Marshall (916) 635-9700; Schweber (916) 929-9732; 

Wyle (916) 638-5282; 

San Diego: Arrow/Kierulff (619) 565-4800; 

Hall-Mark (619) 268-1201; Marshall (619) 578-9600; 
Schweber (619) 450-0454; Wyle (619) 565-9171; 

San Francisco Bay Area: Arrow/Kierulff (408) 745-6600, 
Hall-Mark (408) 432-0900; Marshall (408) 942-4600; 
Schweber (408) 432-7171; Wyle (408) 727-2500; 

Zeus (408) 998-5121. 

COLORADO: Arrow/Kierulff (303) 790-4444; 

Hall-Mark (303) 790-1662; Marshall (303) 451-8383; 
Schwebe' (303) 799-0258; Wyle (303) 457-9953. 

CONNETICUT: Arrow/Kierulff (203) 265-7741; 

Hall-Mark (203) 269-0100; Marshall (203) 265-3822; 
Schweber (203) 748-7080. 

FLORIDA; Ft. Lauderdale: 

Arrow/Kierulff (305) 429-8200; Hall-Mark (305) 971-9280; 
Marshall (305) 977-4880; Schweber (305) 977-7511; 
Orlando: Arrow/Kierulff (305) 725-1480, (305) 682-6923; 
Hall-Mark (305) 855-4020; Marshall (305) 767-8585; 
Schweber (305) 331-7555; Zeus (305) 365-3000; 

Tampa: Hall-Mark (813) 530-4543; 

Marshall (813) 576-1399. 

GEORGIA: Arrow/Kierulff (404) 449-8252; 

Hall-Mark (404) 447-8000; Marshall (404) 923-5750; 
Schweber (404) 449-9170. 

ILLINOIS; Arrow/Kierulff (312) 250-0500; 

Hall-Mark (312) 860-3800; Marshall (312) 490-0155; 
Newark (312) 784-5100; Schweber (312) 364-3750. 

INDIANA: Indianapolis: Arrow/Kierulff (317) 243-9353; 
Hall-Mark (317) 872-8875; Marshall (317) 297-0483. 

IOWA: Arrow/Kierulff (319) 395-7230; 

Schweber (319) 373-1417. 

KANSAS: Kansas City: Arrow/Kierulff (913) 541-9542; 
Hall-Mark (913) 888-4747; Marshall (913) 492-3121; 
Schweber (913) 492-2922. 

MARYLAND; Arrow/Kierulff (301) 995-6002; 

Hall-Mark (301) 988-9800; Marshall (301) 840-9450; 
Schweber (301) 840-5900; Zeus (301) 997-1118. 


MASSACHUSETTS Arrow/Kierulff (617) 935-5134; 
Hall-Mark (617) 667-0902; Marshall (617) 658-0810; 
Schweber (617) 275-5100, (617) 657-0760; 

Time (617) 532-6200; Zeus (617) 863-8800. 

MICHIGAN: Detroit: Arrow/Kierulff (313) 971-8220; 
Marshall (313) 525-5850; Newark (313) 967-0600; 
Schweber (313) 525-8100; 

Grand Rapids: Arrow/Kierulff (616) 243-0912. 

MINNESOTA: Arrow/Kierulff (612) 830-1800; 

Hall-Mark (612) 941-2600; Marshall (612) 559-2211; 
Schweber (612) 941-5280. 

MISSOURI: St. Louis: Arrow/Kierulff (314) 567-6888; 
Hall-Mark (314) 291-5350; Marshall (314) 291-4650; 
Schweber (314) 739-0526. 

NEW HAMPSHIRE: Arrow/Kierulff (603) 668-6968; 
Schweber (603) 625-2250. 

NEW JERSEY: Arrow/Kierulff (201) 538-0900, 

(609) 596-8000; GRS Electronics (609) 964-8560; 
Hall-Mark (201) 575-4415, (609) 235-1900; 

Marshall (201) 882-0320, (609) 234-9100; 

Schweber (201) 227-7880. 

NEW MEXICO: Arrow/Kierulff (505) 243-4566. 

NEW YORK: Long Island: 

Arrow/Kierulff (516) 231-1000; Hall-Mark (516) 737-0600; 
Marshall (516) 273-2424; Schweber (516) 334-''555; 
Zeus (914) 937-7400; 

Rochester; Arrow/Kierulff (716) 427-0300; 

Hall-Mark (716) 244-9290; Marshall (716) 235-7620; 
Schweber (716) 424-2222; 

Syracuse; Marshall (607) 798-1611. 

NORTH CAROLINA: Arrow/Kierulff (919) 876-3132, 
(919) 725-8711; Hall-Mark (919) 872-0712; 

Marshall (919) 878-9882; Schweber (919) 876-0000. 

OHIO: Cleveland: Arrow/Kierulff (216) 248-3990; 
Hall-Mark (216) 349-4632; Marshall (216) 248-1788; 
Schweber (216) 464-2970; 

Columbus: Arrow/Kierulff (614) 436-0928; 

Hall-Mark (614) 888-3313; 

Dayton: Arrow/Kierulff (513) 435-5563; 

Marshall (513) 898-4480; Schweber (513) 439-1800. 

OKLAHOMA: Arrow/Kierulff (918) 252-7537; 

Schweber (918) 622-8003. 

OREGON; Arrow/Kierulff (503) 645-6456; 

Marshall (503) 644-5050; Wyle (503) 640-6000. 

PENNSYLVANIA: Arrow/Kierulff (412) 856-7000, 

(215) 928-1800; GRS Electronics (215) 922-7037; 
Schweber (215) 441-0600. (412) 963-6804. 

TEXAS: Austin: Arrow/Kierulff (512) 835-4180; 
Hall-Mark (512) 258-8848; Marshall (512) 837-1991; 
Schweber (512) 339-0088; Wyle (512) 834-9957; 

Dallas: Arrow/Kierulff (214) 380-6464; 

Hall-Mark (214) 553-4300; Marshall (214) 233-5200; 
Schweber (214) f 31-5010; Wyle (214) 235-9953; 

Zeus (214) 783-7010; 

Houston: Arrow/Kierulff (713) 530-4700; 

Hall-Mark (713) 781-6100; Marshall (713) 895-9200; 
Schweber (713) 784-3600; Wyle (713) 879-9953. 

UTAH; Arrow/Kierulff (801)973-6913; 

Hall-Mark (801) 972-1008; Marshall (801) 485-1551; 

Wyle (801) 974-9953. 

WASHINGTON: Arrow/Kierulff (206) 575-4420; 

Marshall (206) 747-9100; Wyle (206) 453-8300. 

WISCONSIN: Arrow/Kierulff (414) 792-0150; 

Hall-Mark (414) 797-7844; Marshall (414) 797-8400; 
Schweber (414) 784-9020. 

CANADA: Calgary: Future (403) 235-5325; 

Edmonton: Future (403) 438-2858; 

Montreal: Arrow Canada (514) 735-5511; 

Future (514) 694-7710; 

Ottawa: Arrow Canada (613) 226-6903; 

Future (613) 820-8313; 

Quebec City: Arrow Canada (418) 687-4231; 

Toronto: Arrow Canada (416) 672-7769; 

Future (416) 638-4771; 

Vancouver; Future (604) 294-1166; 

Winnipeg: Future (204) 339-0554. 


Customer 
Response Center 


TOLL FREE: (800) 232-3200 

OUTSIDE USA: (214)995-6611 

(8:00 a.m. - 5;00 p.m. CST) 
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